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

踩坑提示：CXR-M SDK 需要 Android API 28+，记得在 defaultConfig 中设置 minSdk = 28。

第二步：配置蓝牙权限

眼镜通过蓝牙与手机连接，需要在 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)
    }
}

第三步：设计数据模型

我选择了三种经典聚会游戏：真心话大冒险、你比我猜、我是谁。数据模型的设计直接影响后续代码的复杂度，所以我在这里花了不少心思：

// 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 // 真心话大冒险需要区分真心话/大冒险
)

这里有一个设计细节：answer 字段是可空的，因为真心话大冒险和你比我猜不需要答案显示。而 isTruth 字段只对真心话大冒险有意义，用于在眼镜上显示「真心话」还是「大冒险」的标题。

预设数据我直接硬编码在 GameData 单例中：

// GameData.kt
object GameData {
    val questions: List<GameQuestion> = listOf(
        // 真心话
        GameQuestion(1, GameType.TRUTH_OR_DARE, "你最近一次哭是什么时候？", null, true),
        GameQuestion(2, GameType.TRUTH_OR_DARE, "你最尴尬的经历是什么？", null, true),
        GameQuestion(3, GameType.TRUTH_OR_DARE, "你有暗恋的人吗？", null, true),
        // 大冒险
        GameQuestion(6, GameType.TRUTH_OR_DARE, "给通讯录第 5 个人打电话说新年快乐", null, false),
        GameQuestion(7, GameType.TRUTH_OR_DARE, "模仿一个动物叫声", null, false),
        // 你比我猜
        GameQuestion(11, GameType.CHARADES, "包饺子", null),
        GameQuestion(12, GameType.CHARADES, "放鞭炮", null),
        // 我是谁
        GameQuestion(17, GameType.WHO_AM_I, "孙悟空", "西游记角色"),
        GameQuestion(18, GameType.WHO_AM_I, "奥特曼", "动漫角色"),
        // ... 更多题目
    )
}

随机选题要避免重复，我实现了一个简单但有效的方法：

// GameData.kt
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()
}

第四步：封装 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)
    }

    interface SendCallback {
        fun onSuccess()
        fun onFailed(errorMsg: String)
    }

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

连接眼镜的流程稍微复杂一些，需要先初始化蓝牙、获取连接信息、再建立连接：

// RokidGlassesManager.kt
fun connectGlasses(context: Context, device: BluetoothDevice) {
    connectionCallback?.onConnecting()
    cxrApi.initBluetooth(context, device, object : BluetoothStatusCallback() {
        override fun onConnectionInfo(uuid: String?, mac: String?, account: String?, type: Int) {
            if (!uuid.isNullOrEmpty() && !mac.isNullOrEmpty()) {
                cxrApi.connectBluetooth(context, uuid, mac, object : BluetoothStatusCallback() {
                    override fun onConnected() {
                        connectionCallback?.onConnected()
                    }
                    override fun onDisconnected() {
                        connectionCallback?.onDisconnected()
                    }
                    override fun onFailed(e: ValueUtil.CxrBluetoothErrorCode?) {
                        connectionCallback?.onFailed(e?.name ?: "连接失败")
                    }
                    // 需要空实现这个方法，即使我们不使用它
                    override fun onConnectionInfo(a: String?, b: String?, c: String?, d: Int) {}
                })
            } else {
                connectionCallback?.onFailed("获取连接信息失败")
            }
        }
        override fun onConnected() {
            connectionCallback?.onConnected()
        }
        override fun onDisconnected() {
            connectionCallback?.onDisconnected()
        }
        override fun onFailed(e: ValueUtil.CxrBluetoothErrorCode?) {
            connectionCallback?.onFailed(e?.name ?: "连接失败")
        }
    })
}

踩坑提示：connectBluetooth 的回调中，onConnectionInfo 方法必须实现，否则可能无法正常回调 onConnected。这个问题困扰了我好几个小时。

查找眼镜设备的逻辑很简单，就是遍历已配对的蓝牙设备：

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

发送内容到眼镜是核心功能。CXR-M SDK 的提词器场景通过 sendStream 方法发送文本：

// RokidGlassesManager.kt
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 语音播报是锦上添花的功能，可以在倒计时结束时播报'时间到'：

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

第五步：主界面逻辑

主界面 MainActivity.kt 负责所有用户交互。我选择了简洁的设计：顶部显示游戏类型和当前题目，底部是操作按钮。

游戏类型切换的逻辑：

// MainActivity.kt
private fun selectGameType(type: GameType) {
    currentType = type
    usedQuestions.clear()
    // 切换游戏时清空已用题目
    binding.tvGameType.text = type.displayName
    nextQuestion()
    updateButtonStyles(type)
}

倒计时功能是你比我猜游戏的核心。我使用 Android 的 CountDownTimer，并在最后 10 秒同步更新眼镜显示：

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

发送到眼镜的内容格式需要精心设计，保证在眼镜上显示清晰易读：

// MainActivity.kt
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("👆 手机点击下一题")
}

四、实际使用体验

开发完成后，我在一次朋友聚会上测试了这个应用。使用流程是：

1. 打开 APP，选择游戏类型
2. 连接 Rokid 眼镜（首次需要配对）
3. 点击「发送到眼镜」，题目出现在眼镜屏幕上
4. 游戏进行中，用手机翻页或启动倒计时

眼镜端的显示效果：

┌──────────────────────────────┐
│ 🎮 你比我猜                  │
│                              │
│ ────── 题目 ──────           │
│                              │
│ 包饺子                       │
│                              │
│ 👆 手机点击下一题             │
└──────────────────────────────┘

实际效果：作为组织者，我终于可以抬头面对参与者，通过眼镜确认题目，而不用低头看手机。游戏节奏明显更流畅了，大家玩得也更尽兴。

五、遇到的问题与解决

问题一：题目全部用完后怎么办？

最初的实现会导致空指针异常。解决方案是在 getRandom 方法中，当没有可用题目时，重新从所有题目中随机选：

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()
}

问题二：倒计时精度问题

CountDownTimer 在某些设备上会有精度问题。对于聚会游戏这种场景，秒级精度足够了，但如果需要更精确的计时，建议使用 Handler + Runnable 的方式：

private val handler = Handler(Looper.getMainLooper())
private var remainingSeconds = 60
private val tickRunnable = object : Runnable {
    override fun run() {
        if (remainingSeconds > 0) {
            remainingSeconds--
            updateDisplay()
            handler.postDelayed(this, 1000)
        } else {
            onTimeUp()
        }
    }
}

问题三：屏幕常亮

游戏过程中屏幕不能熄灭，否则重新唤醒需要时间。解决方案是在 onCreate 中添加：

window.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)

六、功能清单

七、不足与展望

当前版本的不足：

• 题目数量有限，且硬编码在代码中
• 不支持用户自定义添加题目
• 没有积分和排行榜系统
• 只支持单机模式

后续可以改进的方向：

1. 云端题库：将题目存储在云端，支持实时更新
2. 自定义题目：允许用户添加自己的题目
3. 多人模式：通过局域网实现多设备同步
4. 更多游戏：增加狼人杀、谁是卧底等游戏

八、结语

这个项目虽然规模不大，但让我深入理解了 AR 眼镜在日常生活中可能的应用场景。聚会游戏助手解决的不是一个技术难题，而是一个体验问题——让组织者从'管理员'回归'参与者'。

Rokid CXR-M SDK 的封装做得不错，让开发者可以专注于业务逻辑，而不用关心底层通信细节。提词器场景的设计也很巧妙，非常适合这类需要私密显示内容的应用。

如果你也有类似的想法，不妨动手试试。代码量不大，但成就感满满。