![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-1953659/27d55d6940126950a48372eeb4671ec6.png)


如果你在做一个需要接入 Rokid AI 眼镜的 Android 应用——比如远程协作、工业巡检、远程医疗教学——你可能不需要从头啃 CXR SDK 的文档。我们把手机端和眼镜的蓝牙连接层拆出来，做成了一个独立的开源库，封装了 BLE 扫描、连接、重连、状态管理这些基础能力。

这篇文章讲怎么用，以及几个容易踩的坑。

## 三步接入

**Step 1：添加依赖**

```gradle
repositories {
    maven { url = uri("https://maven.rokid.com/repository/maven-public/") }
}

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

**Step 2：初始化 Manager**

```kotlin
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：扫描并连接**

```kotlin
// 开始扫描周边眼镜
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 及以上需要运行时申请蓝牙权限。库提供了一个工具方法直接获取当前系统版本需要的权限列表：

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

不要硬编码权限列表——Android 11、12、13+ 的权限需求不一样，用 `requiredPermissions()` 比你自己写 when 分支靠谱。

## 生命周期管理

Manager 内部持有蓝牙扫描器、Handler 定时器、CXR SDK 连接。如果不释放，Activity 销毁后可能泄漏。调用规范很简单：

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

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

## 一个完整的示例

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

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

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        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_AVAILABLE` 和 `getGlassInfo onResponse`。

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

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

## 这个库和一线互联的关系

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

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

---

*项目地址：[github.com/jumuxyz/jlink-ai-rokid-glasses-bt](https://github.com/jumuxyz/jlink-ai-rokid-glasses-bt)，Apache 2.0 协议。有问题提 Issue，有需求提 PR。*


如果你在做一个需要接入 Rokid AI 眼镜的 Android 应用——比如远程协作、工业巡检、远程医疗教学——你可能不需要从头啃 CXR SDK 的文档。我们把手机端和眼镜的蓝牙连接层拆出来，做成了一个独立的开源库，封装了 BLE 扫描、连接、重连、状态管理这些基础能力。

Rokid AI 眼镜远程协作应用"一线互联"开发实践：开源连接库集成实践

人工智能

本文介绍专为Rokid AI眼镜开发的独立开源蓝牙连接库，简化Android应用（如远程协作、工业巡检）的接入流程。详细讲解三步集成方法：依赖添加、初始化管理器、扫描连接设备，并重点提示权限处理、生命周期管理及实际开发中易错点（如授权文件安全、连接状态判断）。该库封装了BLE核心能力，连接成功后可直接使用CXRSDK进行业务开发，提升开发效率与连接稳定性。

Android

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

本文介绍专为Rokid AI眼镜开发的独立开源蓝牙连接库，简化Android应用（如远程协作、工业巡检）的接入流程。详细讲解三步集成方法：依赖添加、初始化管理器、扫描连接设备，并重点提示权限处理、生命周期管理及实际开发中易错点（如授权文件安全、连接状态判断）。该库封装了BLE核心能力，连接成功后可直接使用CXRSDK进...

Rokid AI 眼镜远程协作应用"一线互联"开发实践：开源连接库集成实践-腾讯云开发者社区-腾讯云

Rokid AI 眼镜远程协作应用"一线互联"开发实践：开源连接库集成实践

Rokid AI 眼镜远程协作应用"一线互联"开发实践：开源连接库集成实践

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐