基于 Rokid AR 眼镜的聚会游戏助手开发实战

背景与需求

传统聚会游戏组织存在信息泄露与节奏失控问题。组织者需频繁查看手机题目，易被旁观者看到，且难以掌控游戏氛围。AR 眼镜方案可实现题目私密显示，让组织者回归参与者角色。

Rokid CXR-M SDK 提供了「提词器场景」能力，可将文字内容推送到眼镜屏幕显示，配合 TTS（语音合成）实现提示播报。

项目架构

核心原则是保持简单，应用包含三个核心类：

com.rokid.game/
├── MainActivity.kt      # 主界面，处理交互逻辑
├── data/
│   └── GameData.kt      # 数据模型和预设题目
└── sdk/
    └── RokidGlassesManager.kt  # SDK 封装层

将 SDK 封装单独放一层，使业务代码与 SDK 实现解耦，便于后续升级或替换方案。

开发步骤

1. 配置项目依赖

在 settings.gradle.kts 中配置仓库：

// settings.gradle.kts
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://s01.oss.sonatype.org/content/repositories/releases/") }
        maven { url = uri("https://s01.oss.sonatype.org/content/repositories/snapshots/") }
    }
}

在 app/build.gradle.kts 中添加依赖：

dependencies {
    implementation("com.rokid.cxr:client-m:1.0.1-20250812.080117-2")
    implementation("androidx.core:core-ktx:1.12.0")
    implementation("androidx.appcompat:appcompat:1.6.1")
    implementation("com.google.android.material:material:1.11.0")
    implementation("androidx.constraintlayout:constraintlayout:2.1.4")
}

注意：CXR-M SDK 需要 Android API 28+，记得在 defaultConfig 中设置 minSdk = 28。

2. 配置蓝牙权限

眼镜通过蓝牙连接，需在 AndroidManifest.xml 中声明权限：

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

Android 12+ 需要动态申请 BLUETOOTH_SCAN 和 BLUETOOTH_CONNECT 权限：

// MainActivity.kt
private fun checkPermissions() {
    val perms = mutableListOf<String>()
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        perms.add(Manifest.permission.BLUETOOTH_SCAN)
        perms.add(Manifest.permission.BLUETOOTH_CONNECT)
    }
    val notGranted = perms.filter { ContextCompat.checkSelfPermission(this, it) != PackageManager.PERMISSION_GRANTED }
    if (notGranted.isNotEmpty()) {
        ActivityCompat.requestPermissions(this, notGranted.toTypedArray(), 100)
    }
}

3. 设计数据模型

支持三种经典聚会游戏：真心话大冒险、你比我猜、我是谁。

// GameData.kt
enum class GameType(val displayName: String) {
    TRUTH_OR_DARE("真心话大冒险"),
    CHARADES("你比我猜"),
    WHO_AM_I("我是谁"),
    COUNTDOWN("数数字")
}

data class GameQuestion(
    val id: Int,
    val gameType: GameType,
    val content: String,
    val answer: String? = null,
    val isTruth: Boolean = true
)

预设数据硬编码在单例中，随机选题避免重复：

object GameData {
    val questions: List<GameQuestion> = listOf(
        GameQuestion(1, GameType.TRUTH_OR_DARE, "你最近一次哭是什么时候？", null, true),
        GameQuestion(6, GameType.TRUTH_OR_DARE, "给通讯录第 5 个人打电话说新年快乐", null, false),
        // ... 更多题目
    )

    fun getRandom(type: GameType, used: Set<Int>): GameQuestion? {
        val available = getByType(type).filter { it.id !in used }
        return if (available.isNotEmpty()) available.random()
        else getByType(type).random()
    }
}

4. 封装 SDK 交互

创建 RokidGlassesManager 单例封装所有与眼镜的交互。

// RokidGlassesManager.kt
object RokidGlassesManager {
    private val cxrApi: CxrApi by lazy { CxrApi.getInstance() }
    private var connectionCallback: ConnectionCallback? = null

    interface ConnectionCallback {
        fun onConnecting()
        fun onConnected()
        fun onDisconnected()
        fun onFailed(errorMsg: String)
    }

    val isConnected: Boolean get() = cxrApi.isBluetoothConnected
}

连接流程需初始化蓝牙、获取连接信息、再建立连接。注意 connectBluetooth 回调中 onConnectionInfo 方法必须实现。

查找眼镜设备遍历已配对蓝牙设备：

fun findRokidGlasses(adapter: BluetoothAdapter): BluetoothDevice? {
    if (ActivityCompat.checkSelfPermission(adapter.javaClass, Manifest.permission.BLUETOOTH_CONNECT) != PackageManager.PERMISSION_GRANTED)
        return null
    return adapter.bondedDevices.find { it.name?.contains("Rokid", ignoreCase = true) == true }
}

发送内容到眼镜使用 sendStream 方法：

fun sendGameContent(text: String, callback: SendCallback? = null): Boolean {
    if (!isConnected) {
        callback?.onFailed("眼镜未连接")
        return false
    }
    cxrApi.controlScene(ValueUtil.CxrSceneType.WORD_TIPS, true, null)
    val status = cxrApi.sendStream(
        ValueUtil.CxrStreamType.WORD_TIPS,
        text.toByteArray(Charsets.UTF_8),
        "game.txt",
        object : SendStatusCallback {
            override fun onSendSucceed() { callback?.onSuccess() }
            override fun onSendFailed(e: ValueUtil.CxrSendErrorCode?) { callback?.onFailed(e?.name ?: "发送失败") }
        }
    )
    return status == ValueUtil.CxrStatus.REQUEST_SUCCEED
}

TTS 语音播报功能：

fun sendTts(text: String): Boolean {
    if (!isConnected) return false
    return if (cxrApi.sendTtsContent(text) == ValueUtil.CxrStatus.REQUEST_SUCCEED) {
        cxrApi.notifyTtsAudioFinished()
        true
    } else false
}

5. 主界面逻辑

MainActivity.kt 负责用户交互。倒计时功能使用 CountDownTimer，最后 10 秒同步更新眼镜显示：

private fun startCountdown() {
    countdownTimer?.cancel()
    binding.tvCountdown.text = "60"
    countdownTimer = object : CountDownTimer(60000, 1000) {
        override fun onTick(millis: Long) {
            binding.tvCountdown.text = "${millis / 1000}"
            if (millis / 1000 <= 10) {
                sendToGlasses("⏱ 倒计时：${millis / 1000}秒")
            }
        }
        override fun onFinish() {
            binding.tvCountdown.text = "0"
            RokidGlassesManager.sendTts("时间到！")
        }
    }.start()
}

发送到眼镜的内容格式需保证清晰易读：

private fun buildDisplayText(): String = buildString {
    val q = currentQuestion ?: return ""
    appendLine("🎮 ${currentType.displayName}")
    appendLine()
    if (currentType == GameType.TRUTH_OR_DARE) {
        appendLine("────── ${if (q.isTruth) "真心话" else "大冒险"} ──────")
    } else {
        appendLine("────── 题目 ──────")
    }
    appendLine()
    appendLine(q.content)
    appendLine()
    appendLine("👆 手机点击下一题")
}

功能清单

功能	说明
四种游戏	真心话大冒险/你比我猜/我是谁/数字
随机出题	自动避免重复
60 秒倒计时	你比我猜模式专用，最后 10 秒同步眼镜
眼镜同步	题目实时推送到眼镜显示
TTS 语音	倒计时结束播报'时间到'
蓝牙连接	自动查找已配对的 Rokid 设备

常见问题解决

题目用完后空指针：在 getRandom 方法中，当无可用题目时重新从所有题目中随机选。
倒计时精度：CountDownTimer 在某些设备有精度问题，建议 Handler + Runnable 方式实现更精确计时。
屏幕常亮：在 onCreate 中添加 window.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)。

局限与展望

当前版本不足：题目数量有限且硬编码；不支持自定义添加题目；无积分排行榜；仅支持单机。

后续改进方向：云端题库、自定义题目、多人局域网同步、增加狼人杀等游戏。

参考文档

CXR-M SDK 官方文档

基于 Rokid AR 眼镜的聚会游戏助手开发实战

背景与需求

项目架构

开发步骤

1. 配置项目依赖

2. 配置蓝牙权限

3. 设计数据模型

4. 封装 SDK 交互

5. 主界面逻辑

功能清单

常见问题解决

局限与展望

参考文档

更多推荐文章

相关免费在线工具

基于 Rokid AR 眼镜的聚会游戏助手开发实战

背景与需求

项目架构

开发步骤

1. 配置项目依赖

2. 配置蓝牙权限

3. 设计数据模型

4. 封装 SDK 交互

5. 主界面逻辑

功能清单

常见问题解决

局限与展望

参考文档

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具