
![image.png](https://developer.qcloudimg.com/http-save/yehe-1953659/e510bf7404d6077a044b7c1537d8e5fd.png)
连接 Rokid AI 眼镜的时候，CXR SDK 会在连接成功后回调 `onConnected()`。大多数时候这个回调是准的，但少数情况下它不来——SDK 内部状态已经 Connected 了，但回调没触发。

这个问题第一次出现的时候，我们花了一下午才定位到：不是没连上，是连上了但没人告诉你连上了。

## 不能只靠回调

SDK 的 `isBluetoothConnected` 属性是可信的——它是 SDK 内部状态的一个直接查询，返回 true 就说明链路已经建立。所以解决办法很简单：**在发起连接后，启动一个轮询去检查 `isBluetoothConnected`，回调不来就轮询补上**。

```kotlin
private fun scheduleConnectedStatePoll(generation: Int, attempt: Int = 0) {
    val delayMs = CONNECTED_STATE_POLL_DELAYS_MS.getOrNull(attempt) ?: return
    mainHandler.postDelayed({
        // generation 变了说明连接已经结束或重试了
        if (connectGeneration != generation) return@postDelayed

        val currentState = _state.value
        if (currentState != RokidGlassesBtState.ResolvingEndpoint &&
            currentState != RokidGlassesBtState.Connecting
        ) return@postDelayed  // 已经进入终态

        if (syncConnectedStateFromSdk()) return@postDelayed  // 确认已连接

        scheduleConnectedStatePoll(generation, attempt + 1)  // 下一轮
    }, delayMs)
}

private fun syncConnectedStateFromSdk(): Boolean {
    if (!isConnected()) return false

    val endpoint = pendingEndpoint ?: endpointStore.load()
    if (endpoint != null && RokidGlassesBtEndpointValidator.validate(endpoint) == null) {
        endpointStore.save(endpoint)
    }
    cancelConnectTimeout()
    pendingEndpoint = null
    activeConnectStage = null
    _state.value = RokidGlassesBtStateReducer.connected()
    return true
}
```

## 轮询间隔为什么是指数递增的

轮询频率的选择是个权衡。太快了浪费 CPU，太慢了用户感知到延迟。我们用了一组指数递增的延迟：

```kotlin
val CONNECTED_STATE_POLL_DELAYS_MS = longArrayOf(
    500L,       // 第 1 次：0.5 秒
    1_000L,     // 第 2 次：1 秒
    2_000L,     // 第 3 次：2 秒
    4_000L,     // 第 4 次：4 秒
    8_000L,     // 第 5 次：8 秒
    16_000L,    // 第 6 次：16 秒
    32_000L     // 第 7 次：32 秒
)
```

前几次间隔短，因为连接通常在几百毫秒到一两秒内完成。后面的间隔拉开，避免长时间空转。七次轮询覆盖了大约 63 秒的时间窗口，超过这个时间还连不上，大概率是真的有问题，让超时逻辑去接管。

## 轮询怎么知道该停了

三个条件：

1. **generation 变了**——说明用户发起了新的连接请求或 disconnect，当前轮询作废
2. **状态已经不是 ResolvingEndpoint 或 Connecting**——说明已经进入终态（Connected/Failed/Disconnected），没必要再查
3. **syncConnectedStateFromSdk 返回 true**——已经确认连接，停止轮询

这里 generation 的判断很重要。没有它的话，上一轮连接的轮询任务可能在新连接发起后仍然在执行，把状态搞乱：

```kotlin
if (connectGeneration != generation) return@postDelayed
```

## 在 connectBluetooth 发起后就立刻启动轮询

轮询的启动时机在 `connectBluetoothInternal` 方法里，紧跟在 `cxrClient.connectBluetooth` 调用之后：

```kotlin
private fun connectBluetoothInternal(
    endpoint: RokidGlassesBtEndpoint,
    stage: RokidGlassesBtStage
): Boolean {
    // ... 校验 endpoint、鉴权、设置状态为 Connecting ...

    return runCatching {
        cxrClient.connectBluetooth(
            appContext, endpoint.socketUuid, endpoint.macAddress,
            config.bluetoothClientName, bluetoothCallback,
            config.authBlob, config.clientSecretForSdk
        )
    }.onSuccess {
        scheduleConnectedStatePoll(generation)  // 启动轮询
    }.onFailure { error ->
        cancelConnectTimeout()
        endpointStore.clear()
        _state.value = RokidGlassesBtStateReducer.failed(
            stage = stage, code = RokidGlassesBtErrorCode.SDK_EXCEPTION,
            detail = error.message
        )
    }.isSuccess
}
```

## 这其实是一个通用模式

"异步回调 + 定时轮询兜底"不是我们发明的，但在蓝牙 SDK 对接这个场景里特别好用。第三方 SDK 的回调可靠性你是控制不了的——它可能因为内部线程调度问题、生命周期问题、版本兼容问题不回调。加一层兜底轮询，代价很小（几行代码、微乎其微的 CPU 开销），收益是消灭了一整类"假性连接失败"。

---

> 相关仓库：[github.com/jumuxyz/jlink-ai-rokid-glasses-bt](https://github.com/jumuxyz/jlink-ai-rokid-glasses-bt) · Apache 2.0

遇到类似问题的时候可以参考这个思路：**主路径用回调，兜底用轮询，轮询间隔用指数递增，用 generation 计数器防止状态污染**。

连接 Rokid AI 眼镜的时候，CXR SDK 会在连接成功后回调 onConnected()。大多数时候这个回调是准的，但少数情况下它不来——SDK 内部状态已经 Connected 了，但回调没触发。

Rokid AI 眼镜远程协作应用"一线互联"开发实践：SDK 轮询兜底与可靠性保障

客户端

开发工具

物联网

针对RokidAI眼镜连接中SDK回调onConnected()偶尔缺失的问题，本文提出了一种可靠的解决方案：通过指数递增轮询检查isBluetoothConnected状态作为回调的兜底机制。该方法在连接发起后启动轮询，确保即使回调未触发也能准确判断连接状态，避免假性连接失败。轮询间隔从0.5秒逐步增至32秒，兼顾效率与资源消耗，有效提升连接稳定性。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

针对RokidAI眼镜连接中SDK回调onConnected()偶尔缺失的问题，本文提出了一种可靠的解决方案：通过指数递增轮询检查isBluetoothConnected状态作为回调的兜底机制。该方法在连接发起后启动轮询，确保即使回调未触发也能准确判断连接状态，避免假性连接失败。轮询间隔从0.5秒逐步增至32秒，兼顾效...

Rokid AI 眼镜远程协作应用"一线互联"开发实践：SDK 轮询兜底与可靠性保障-腾讯云开发者社区-腾讯云

Rokid AI 眼镜远程协作应用"一线互联"开发实践：SDK 轮询兜底与可靠性保障

Rokid AI 眼镜远程协作应用"一线互联"开发实践：SDK 轮询兜底与可靠性保障

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐