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

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

功能清单

常见问题解决

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

局限与展望

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

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

参考文档

CXR-M SDK 官方文档