Rokid AI眼镜远程协作开发：开源连接库集成实践全解析

如果你正在开发的 Android 应用需要跟 Rokid AI 眼镜打交道——比如远程协作、工业巡检、远程医疗教学——其实不用自己从头硬啃 CXR SDK 那套 BLE 连接逻辑。我们把手机和眼镜之间最磨人的蓝牙连接层单独拆了出来，做成一个独立库，把扫描、连接、重连、状态管理这些基础能力都封装好了。

下面直接说怎么用，顺带提几个实际踩过的坑。

三步接入

Step 1：添加依赖

repositories {
    ma ven { url = uri("https://ma ven.rokid.com/repository/ma ven-public/") }
}

dependencies {
    implementation "xyz.jumu.rokid:glasses-bt-core:0.1.0-SNAPSHOT"
}

Step 2：初始化 Manager

val manager = RokidGlassesBtManager(
    context = context,
    config = RokidGlassesBtConfig(
        clientSecret = "your-rokid-client-secret",
        authBlob = loadAuthBlobFromFile("rokid_cxr_auth.lc"),
        bluetoothClientName = "一线互联"
    )
)

authBlob 是 Rokid 提供的 .lc 授权文件，需要去 Rokid 开发者平台拿到。clientSecret 是开发者密钥。这两个凭证千万别硬编码在代码里，建议从配置文件或环境变量读取。

Step 3：扫描并连接

// 开始扫描周边眼镜
manager.startScan()

// 监听设备列表，展示给用户选择
manager.devices.collect { devices ->
    devices.forEach { device ->
        println("${device.name}RSSI: ${device.rssi}")
    }
}

// 用户点击后连接
manager.connect(selectedDevice)

// 监听连接状态
manager.state.collect { state ->
    when (state) {
        RokidGlassesBtState.Connected -> onGlassesReady()
        is RokidGlassesBtState.Failed -> handleError(state.stage, state.code)
        else -> updateProgress(state)
    }
}

连接成功后怎么用

这个库只管连接管理，连接建立之后，视频流获取、传感器数据读取这些后续操作，依然走 CXR SDK 的其他接口。开源库在 Connected 状态确认后就不再插手业务层，你可以直接对接 CXR SDK，或者跑自己定义的协议。

顺带解释一下它和上层产品的关系：开源库本质是“连接层”，上层应用在这个基础上加视频推流、WebRTC 信令、任务同步、取证管理等业务模块。如果你有自己的一套业务，完全可以直接拿连接层往上搭。

权限处理

Android 12 及以上需要在运行时申请蓝牙权限。库提供了一个工具方法，能直接返回当前系统版本需要的权限列表：

class MainActivity : Activity() {
    override fun onCreate(sa vedInstanceState: Bundle?) {
        super.onCreate(sa vedInstanceState)
        // 检查缺失的权限
        val missing = RokidGlassesBtPermission.missingPermissions(this)
        if (missing.isNotEmpty()) {
            requestPermissions(missing.toTypedArray(), REQUEST_CODE)
        }
    }
}

不建议硬编码权限列表——Android 11、12、13 的权限需求是不一样的，用 requiredPermissions() 动态获取比你自己写 when 分支靠谱得多。

生命周期管理

Manager 内部持有蓝牙扫描器、Handler 定时器、CXR SDK 连接。如果不主动释放，Activity 销毁后很容易泄漏。调用逻辑很简单：

override fun onDestroy() {
    manager.close()
    super.onDestroy()
}

close() 会依次做：停止 BLE 扫描、取消所有超时和轮询定时器、清理 pending endpoint、调用 CXR SDK 的 deinitBluetooth() 断开连接、状态置为 Disconnected。内部有幂等保护，放心多次调用。

一个完整的示例

把上面的拼起来，一个最小可用的 Activity 大概长这样：

class GlassesActivity : Activity() {
    private val scope = MainScope()
    private lateinit var manager: RokidGlassesBtManager

    override fun onCreate(sa vedInstanceState: Bundle?) {
        super.onCreate(sa vedInstanceState)

        manager = RokidGlassesBtManager(
            context = applicationContext,
            config = RokidGlassesBtConfig(
                clientSecret = BuildConfig.ROKID_CLIENT_SECRET,
                authBlob = loadAuthBlob(),
                bluetoothClientName = "一线互联"
            )
        )

        // 监听设备
        scope.launch {
            manager.devices.collect { devices -> updateDeviceList(devices) }
        }

        // 监听状态
        scope.launch {
            manager.state.collect { state -> updateState(state) }
        }

        // 检查权限，没问题就开始扫
        if (RokidGlassesBtPermission.missingPermissions(this).isEmpty()) {
            manager.startScan()
        }
    }

    fun onDeviceClicked(device: RokidGlassesBtDevice) {
        manager.connect(device)
    }

    override fun onDestroy() {
        manager.close()
        scope.cancel()
        super.onDestroy()
    }

    private fun loadAuthBlob(): ByteArray {
        return assets.open("rokid_cxr_auth.lc").use { it.readBytes() }
    }
}

几个实际踩过的坑

1. 不要依赖 dumpsys 判断连接状态。
Android 的 dumpsys bluetooth_manager 不一定能显示 CXR Socket 连接。判断连接是否成功的可靠方式是：App 状态变成 Connected，同时 logcat 里能看到 BLUETOOTH_A VAILABLE 和 getGlassInfo onResponse。

2. authBlob 文件不要提交到版本管理。
.lc 文件是设备授权凭证，相当于密码。示例项目里把它放在 sample-app/src/main/assets/ 下，并在 .gitignore 中排除了 *.lc。你照做就行。

3. 重连失败不要直接弹错误。
先判断错误码：如果是 SOCKET_CONNECT_FAILED，说明缓存失效，自动触发一次新扫描——用户不需要知道背后发生了什么。只有多次重试失败后才提示用户介入。

这个库和一线互联的关系

一线互联智能单兵系统的手机端就是基于这个连接库构建的。在眼镜连接稳定的前提下，上层叠加了视频推流、WebRTC 信令、任务管理、取证留痕等业务模块。

我们把连接层开源，是因为它本身足够通用——任何需要手机和 Rokid 眼镜通信的 Android 应用都能直接使用；二是因为连接层最能体现蓝牙连接在工业场景下的可靠性工程——状态机、失败模型、重连策略、轮询兜底，这些设计放到其他蓝牙 SDK 对接场景里也很有参考价值。

来源：互联网