从零跑起 RokidDemo：开发小白也能搞定的入门实践

如果你第一次接触 Rokid 眼镜生态，RokidDemo 就是你的“手机端和眼镜端的桥”。它不是一个只能装起来的示例，而是一个能把手机和眼镜真正连在一起、做互动、做协同的基线工程。你能在它里边看到：

• 扫描发现 Rokid 眼镜，并完成蓝牙连接与鉴权
  
• 拉取眼镜的状态（电量、音量、亮度、充电）并在手机端展示与调节
  
• 打开眼镜相机拍照并把图片回传到手机端保存与入库
  
• 下发自定义界面到眼镜端（比如弹出一个文字提示）
  
• 发送全局消息/TTS 反馈
  
• 模拟遥控器按键，通过 HID 报文控制眼镜（方向、返回、音量）
  
• 把这些交互过程写入数据库，能分页查看记录
  

一句话：它就是你要做“手机+眼镜”协同应用时的起跑线。项目代码地址已经在github上了，这里感谢作者的代码样例：https://github.com/StudiousXiaoYu/RokidDemo
安装环境（Windows）

这个环节很关键，基本所有“构建失败”“设备不识别”的坑都和环境有关。
安装Kotlin

由于整个项目代码环境是Kotlin环境，我们先本地IDE中安装好相关插件。

安装 Android Studio 和 OpenJDK 11

查看是否有安装环境

winget search --source winget Android | Select-String -Pattern "Android Studio|SDK|Platform Tools|OpenJDK"

安装OpenJDK.11

winget install -e --id Microsoft.OpenJDK.11 --accept-source-agreements --accept-package-agreements

安装AndroidStudio

winget install -e --id Google.AndroidStudio --accept-source-agreements --accept-package-agreements

安装PlatformTools

winget install -e --id Google.PlatformTools --accept-source-agreements --accept-package-agreements

自此基本环境就安装完成了。
安装 Android SDK 组件

确保安装这些：

• Android SDK Platform 36（匹配项目 compileSdk 36）
  
• Android SDK Build-Tools 35（或兼容版本）
  
• Android SDK Platform-Tools（包含 adb）
  
• Android SDK Command-line Tools (latest)（方便命令行管理）
  

启动Android SDK Studio后，我们进入设置页找到“SDK Tools”，找到相关的工具，点击下载即可，如图所示：

真机调试准备

手机开启“开发者选项”和“USB 调试”。

第一次连接时，手机会弹窗问是否允许 USB 调试，请选择允许并勾选“始终允许”。
Windows 某些设备会缺驱动，装 Google USB Driver。确保终端输入 adb devices 能看到设备。
项目技术细节

这一节把工程先跑起来，跟着做就能过构建。 先做三步：设置 local.properties → 添加 Rokid 仓库 → 引入 client-m 依赖。
项目根目录有 local.properties，需要把 sdk.dir 指向你机器的 Android SDK 路径（常见是 C:\Users\你的用户名\AppData\Local\Android\Sdk）。

sdk.dir=C:\Users\yu\AppData\Local\Android\Sdk

仓库与依赖（Gradle）
在顶层加仓库，在模块里加依赖，然后点 Gradle Sync。

1. // settings.gradle
2. pluginManagement {
3.   repositories {
4.     gradlePluginPortal()
5.     google()
6.     mavenCentral()
7.     maven { url 'https://maven.rokid.com/repository/maven-public' }
8.   }
9. }
10. dependencyResolutionManagement {
11.   repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
12.   repositories {
13.     google()
14.     mavenCentral()
15.     maven { url 'https://maven.rokid.com/repository/maven-public' }
16.   }
17. }

复制代码

1. // app/build.gradle
2. android {
3.     defaultConfig {
4.         minSdk = 28
5.     }
6. }
7. dependencies {
8.     implementation("com.rokid.cxr:client-m:1.0.1-20250812.080117-2")
9. }

复制代码

检查：sdk.dir 路径有效，依赖能解析，Sync 无报错。
Manifest 权限与特性（Android 12+）

先把这些权限加到 AndroidManifest.xml，Android 12+ 还需要在运行时申请。

1. [/code]蓝牙相关权限在连接前先申请；前台服务能避免进程被系统回收。
2. [size=6]构建与安装[/size]
4. 现在把包编译到真机上。 前置条件：adb devices 显示设备为 device。
5. windows的命令脚本已经在项目里了。
6. [list=1]
7. [*]构建 Debug 包：
8. [/list][indent].\gradlew.bat assembleDebug -x lint
9. [/indent][list=1]
10. [*]安装到设备：
11. [/list][indent].\gradlew.bat installDebug
12. [/indent][list=1]
13. [*]启动入口 Activity：
14. [/list][indent]adb shell am start -n com.blue.armobile/com.blue.glassesapp.feature.init.InitActivity
15. [/indent]首次进入会弹权限提示，请授予存储与通知权限以免初始化阻塞。
16. [align=center] [/align]
17. 添加相关的权限后，我们就可以正常进入手机端的应用界面了，如图所示：
18. [align=center] [/align]
19. [size=5]设备链接[/size]
21. 在开始之前，请先完成“SDK 导入”。我这里使用的是蓝牙扫描添加设备。
22. [align=center] [/align]
23. [size=4]1 查找蓝牙设备[/size]
25. [code]package com.rokid.cxrandroiddocsample.helpers
26. // imports 省略：请确保已引入 Bluetooth*、Scan*、LiveData、ActivityResultContracts 等相关类
28. class BluetoothHelper(
29.   val context: AppCompatActivity,
30.   val initStatus: (INIT_STATUS) -> Unit,
31.   val deviceFound: () -> Unit
32. ) {
33.   companion object {
34.     const val TAG = "Rokid Glasses CXR-M"
35.     const val REQUEST_CODE_PERMISSIONS = 100
36.     // 必要权限：Android 12+ 需申请 BLUETOOTH_SCAN / BLUETOOTH_CONNECT
37.     private val REQUIRED_PERMISSIONS = mutableListOf(
38.       Manifest.permission.ACCESS_FINE_LOCATION,
39.       Manifest.permission.BLUETOOTH,
40.       Manifest.permission.BLUETOOTH_ADMIN,
41.     ).apply {
42.       if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
43.         add(Manifest.permission.BLUETOOTH_SCAN)
44.         add(Manifest.permission.BLUETOOTH_CONNECT)
45.       }
46.     }.toTypedArray()
47.     // 初始化阶段标记：用于引导 UI 与流程
48.     enum class INIT_STATUS { NotStart, INITING, INIT_END }
49.   }
51.   val scanResultMap: ConcurrentHashMap<String, BluetoothDevice> = ConcurrentHashMap()
52.   val bondedDeviceMap: ConcurrentHashMap<String, BluetoothDevice> = ConcurrentHashMap()
53.   private var adapter: BluetoothAdapter? = null
54.   private var manager: BluetoothManager? = null
56.   // 从 Adapter 拿到 BLE Scanner；设备不支持时抛错并提示授权
57.   private val scanner by lazy {
58.     adapter?.bluetoothLeScanner ?: run {
59.       showRequestPermissionDialog()
60.       throw Exception("Bluetooth is not supported!!")
61.     }
62.   }
64.   @SuppressLint("MissingPermission")
65.   // 监听蓝牙是否启用：启用后触发扫描；未启用则引导开启
66.   private val bluetoothEnabled: MutableLiveData<Boolean> = MutableLiveData<Boolean>().apply {
67.     this.observe(context) {
68.       if (this.value == true) {
69.         initStatus.invoke(INIT_STATUS.INIT_END)
70.         startScan()
71.       } else {
72.         showRequestBluetoothEnableDialog()
73.       }
74.     }
75.   }
77.   // 引导用户开启系统蓝牙开关
78.   private val requestBluetoothEnable = context.registerForActivityResult(
79.     ActivityResultContracts.StartActivityForResult()
80.   ) { result ->
81.     if (result.resultCode == Activity.RESULT_OK) {
82.       adapter = manager?.adapter
83.     } else {
84.       showRequestBluetoothEnableDialog()
85.     }
86.   }
88.   private var adapterSetter: BluetoothAdapter? = null
89.     set(value) {
90.       field = value
91.       value?.let {
92.         if (!it.isEnabled) {
93.           requestBluetoothEnable.launch(Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE))
94.         } else {
95.           bluetoothEnabled.postValue(true)
96.         }
97.       }
98.     }
100.   private var managerSetter: BluetoothManager? = null
101.     set(value) {
102.       field = value
103.       initStatus.invoke(INIT_STATUS.INITING)
104.       value?.let { adapterSetter = it.adapter } ?: run { showRequestPermissionDialog() }
105.     }
107.   // 权限结果：成功则初始化 BluetoothManager；失败弹权限提示
108.   val permissionResult: MutableLiveData<Boolean> = MutableLiveData<Boolean>().apply {
109.     this.observe(context) {
110.       if (it == true) {
111.         managerSetter = context.getSystemService(AppCompatActivity.BLUETOOTH_SERVICE) as BluetoothManager
112.       } else {
113.         showRequestPermissionDialog()
114.       }
115.     }
116.   }
118.   // 扫描回调：按设备名缓存，发现设备回调 UI 刷新
119.   val scanListener = object : ScanCallback() {
120.     @SuppressLint("MissingPermission")
121.     override fun onScanResult(callbackType: Int, result: ScanResult?) {
122.       super.onScanResult(callbackType, result)
123.       result?.let { r ->
124.         r.device.name?.let {
125.           scanResultMap[it] = r.device
126.           deviceFound.invoke()
127.         }
128.       }
129.     }
130.     override fun onScanFailed(errorCode: Int) {
131.     }
132.   }
134.   fun checkPermissions() {
135.     initStatus.invoke(INIT_STATUS.NotStart)
136.     context.requestPermissions(REQUIRED_PERMISSIONS, REQUEST_CODE_PERMISSIONS)
137.     context.registerReceiver(
138.       bluetoothStateListener,
139.       IntentFilter(BluetoothAdapter.ACTION_STATE_CHANGED)
140.     )
141.   }
143.   @SuppressLint("MissingPermission")
144.   fun release() {
145.     context.unregisterReceiver(bluetoothStateListener)
146.     stopScan()
147.     permissionResult.postValue(false)
148.     bluetoothEnabled.postValue(false)
149.   }
151.   private fun showRequestPermissionDialog() { }
152.   private fun showRequestBluetoothEnableDialog() { }
154.   @SuppressLint("MissingPermission")
155.   @RequiresPermission(Manifest.permission.BLUETOOTH_SCAN)
156.   fun startScan() {
157.     scanResultMap.clear()
158.     try {
159.       // 使用 Service UUID 过滤 Rokid 眼镜
160.       scanner.startScan(
161.         listOf(
162.           ScanFilter.Builder()
163.             .setServiceUuid(ParcelUuid.fromString("00009100-0000-1000-8000-00805f9b34fb"))
164.             .build()
165.         ),
166.         ScanSettings.Builder().build(),
167.         scanListener
168.       )
169.     } catch (_: Exception) { }
170.   }
172.   @RequiresPermission(Manifest.permission.BLUETOOTH_SCAN)
173.   fun stopScan() {
174.     // 停止扫描，释放回调
175.     scanner.stopScan(scanListener)
176.   }
178.   val bluetoothStateListener = object : BroadcastReceiver() {
179.     override fun onReceive(context: Context?, intent: Intent?) {
180.       val action = intent?.action
181.       if (action == BluetoothAdapter.ACTION_STATE_CHANGED) {
182.         val state = intent.getIntExtra(BluetoothAdapter.EXTRA_STATE, BluetoothAdapter.ERROR)
183.         if (state == BluetoothAdapter.STATE_OFF) {
184.           initStatus.invoke(INIT_STATUS.NotStart)
185.           bluetoothEnabled.postValue(false)
186.         }
187.       }
188.     }
189.   }
190. }

复制代码

2 初始化蓝牙获取蓝牙信息

1. fun initDevice(context: Context, device: BluetoothDevice){
2.   // 通过 CXR 初始化蓝牙模块，监听连接信息与状态
3.   CxrApi.getInstance().initBluetooth(context, device,  object : BluetoothStatusCallback{
4.     override fun onConnectionInfo(
5.       socketUuid: String?,
6.       macAddress: String?,
7.       rokidAccount: String?,
8.       glassesType: Int
9.     ) {
10.       // 成功返回 socketUuid 与 macAddress，用于后续 connectBluetooth
11.       socketUuid?.let { uuid ->
12.         macAddress?.let { address->
13.           connect(context, uuid, address)
14.         }
15.       }
16.     }
17.     // 蓝牙已建立数据通道
18.     override fun onConnected() { }
19.     // 蓝牙数据通道断开
20.     override fun onDisconnected() { }
21.     // 初始化失败，携带错误码
22.     override fun onFailed(p0: ValueUtil.CxrBluetoothErrorCode?) { }
23.   })
24. }

复制代码

3 连接蓝牙模块

1. fun connect(context: Context, socketUuid: String, macAddress: String){
2.   // 使用初始化阶段返回的 socketUuid 与 macAddress 建立蓝牙通信链路
3.   CxrApi.getInstance().connectBluetooth(context, socketUuid, macAddress, object : BluetoothStatusCallback{
4.     override fun onConnectionInfo(
5.       socketUuid: String?,
6.       macAddress: String?,
7.       rokidAccount: String?,
8.       glassesType: Int
9.     ) { }
10.     // 连接成功
11.     override fun onConnected() { }
12.     // 连接断开
13.     override fun onDisconnected() { }
14.     // 连接失败，查看错误码定位问题
15.     override fun onFailed(p0: ValueUtil.CxrBluetoothErrorCode?) { }
16.   })
17. }

复制代码

4 获取蓝牙通信模块连接状态

1. fun getConnectionStatus(): Boolean{
2.   // true：已连接；false：未连接
3.   return CxrApi.getInstance().isBluetoothConnected
4. }

复制代码

5 反初始化蓝牙

1. fun deInit(){
2.   // 释放蓝牙通信模块，清理内部状态
3.   CxrApi.getInstance().deinitBluetooth()
4. }

复制代码

6 蓝牙重连

1. fun reconnect(context: Context, socketUuid: String, macAddress: String){
2.   // 断开后使用同一 socketUuid 与 macAddress 尝试重连
3.   CxrApi.getInstance().connectBluetooth(context, socketUuid, macAddress, object : BluetoothStatusCallback{ })
4. }

复制代码

Wi‑Fi 连接

1. fun initWifi(): ValueUtil.CxrStatus?{
2.   // 初始化 Wi‑Fi P2P 通信模块，蓝牙链路建立后再使用
3.   return CxrApi.getInstance().initWifiP2P(object : WifiP2PStatusCallback{
4.     override fun onConnected() { /* Wi‑Fi P2P 建立成功 */ }
5.     override fun onDisconnected() { /* Wi‑Fi P2P 断开 */ }
6.     override fun onFailed(errorCode: ValueUtil.CxrWifiErrorCode?) { /* 根据错误码处理 */ }
7.   })
8. }

复制代码

1. fun getWiFiConnectionStatus(): Boolean{
2.   // true：Wi‑Fi P2P 已连接；false：未连接
3.   return CxrApi.getInstance().isWifiP2PConnected
4. }

复制代码

1. private fun deinitWifi(){
2.   // 释放 Wi‑Fi P2P 模块
3.   CxrApi.getInstance().deinitWifiP2P()
4. }

复制代码

• 扫描阶段只做发现与过滤，关键是拿到设备标识（名称、MAC 等）
  
• initBluetooth 返回 socketUuid 与 macAddress，这两个是后续通信的入口参数
  
• 真正的数据链路在 connectBluetooth 建立，成功后才算可用
  
• 连接状态用 isBluetoothConnected 判断，断开要及时做 UI 与重试处理
  
• Wi‑Fi P2P 作为大数据传输通道，建议在蓝牙稳定后再开启，避免耗电与不必要的失败
  

拍照录音

拍照（三种途径）

• 单机按键拍照：先设置分辨率，照片存入未同步媒体文件
  
• AI 场景拍照：打开相机并拍照，经蓝牙返回 WebP 字节
  
• 唤起相机拍照：直接拿到照片路径，再做本地/同步处理
  

1. // 单机按键：设置拍照分辨率
2. CxrApi.getInstance().setPhotoParams(width, height)
4. // AI 场景：打开相机 + 拍照（quality: 0~100）
5. CxrApi.getInstance().openGlassCamera(width, height, quality)
6. CxrApi.getInstance().takeGlassPhoto(width, height, quality, photoResultCallback)
8. // 直接唤起相机：返回照片路径
9. CxrApi.getInstance().takeGlassPhoto(width, height, quality, photoPathCallback)

复制代码

photoResultCallback 返回状态与 WebP 字节；photoPathCallback 返回状态与存储路径。经蓝牙传输时建议选较小分辨率与合适质量，避免耗时与失败。
数据操作

数据操作前请确保设备处于蓝牙连接状态；同步媒体文件前需先初始化 Wi‑Fi 通信模块。
向眼镜端发送数据

1. val streamCallback = object : SendStatusCallback {
2.   override fun onSendSucceed() {}
3.   override fun onSendFailed(errorCode: ValueUtil.CxrSendErrorCode?) {}
4. }
5. CxrApi.getInstance().sendStream(ValueUtil.CxrStreamType.WORD_TIPS, bytes, fileName, streamCallback)

复制代码

sendStream 用于向眼镜端发送流数据（如提词内容）；成功与失败通过回调告知，失败可根据错误码定位。
读取未同步媒体文件数量

1. val unSyncCallback = object : UnsyncNumResultCallback {
2.   override fun onUnsyncNumResult(status: ValueUtil.CxrStatus?, audioNum: Int, pictureNum: Int, videoNum: Int) {}
3. }
4. CxrApi.getInstance().getUnsyncNum(unSyncCallback)

复制代码

返回音频、图片、视频三类未同步数量，可用于提醒或批量同步的前置判断。
监听眼镜端媒体文件更新

1. val mediaFileUpdateListener = object : MediaFilesUpdateListener { override fun onMediaFilesUpdated() {} }
2. CxrApi.getInstance().setMediaFilesUpdateListener(mediaFileUpdateListener)

复制代码

当眼镜端媒体库有更新时触发；需要时设置，不用时移除，降低资源占用。
同步媒体文件（需 Wi‑Fi）

1. val syncCallback = object : SyncStatusCallback {
2.   override fun onSyncStart() {}
3.   override fun onSingleFileSynced(fileName: String?) {}
4.   override fun onSyncFailed() {}
5.   override fun onSyncFinished() {}
6. }
7. CxrApi.getInstance().startSync(savePath, arrayOf(ValueUtil.CxrMediaType.PICTURE, ValueUtil.CxrMediaType.VIDEO), syncCallback)

复制代码

同时同步多类型文件；保存路径需具备文件管理权限；开始与完成、单文件成功与失败均在回调通知。

1. CxrApi.getInstance().syncSingleFile(savePath, ValueUtil.CxrMediaType.PICTURE, fileName, syncCallback)
2. CxrApi.getInstance().stopSync()

复制代码

同步指定单个文件与停止同步；单文件更适合“选择后同步”的场景。
常见问题与排障

• 依赖解析失败 → 未配置 Rokid 仓库 → 在 settings.gradle 添加 maven 仓库
  
• 蓝牙扫描失败 → 未申请运行时权限 → 申请 BLUETOOTH_SCAN/CONNECT
  
• 鉴权失败 → .lc 未打包或资源 ID 错误 → 放入 res/raw 并读取校验
  
• 构建错误 → compileSdk 与 SDK 不匹配 → 统一为 compileSdk 36
  
• 初始化卡住 → 未授予存储/通知权限 → 在首次启动时授予权限
  

总结

到这里你已经把环境、依赖、权限都配好，能连上眼镜并跑过音量/亮度、拍照、消息和数据记录。在这篇文章中，我们详细介绍了如何搭建与优化Rokid眼镜和手机端的协同应用。通过提供的示例代码和详细的安装步骤，读者能够快速上手，完成手机与眼镜的连接，并实现音量调节、拍照、信息推送等基础功能。关键的技术点包括环境配置、Android Studio的设置、以及如何进行设备连接与权限管理等。
通过实际的功能实现案例，如蓝牙连接、TTS反馈和远程控制等，我们进一步探讨了如何利用CXR SDK实现眼镜与手机的交互。这些功能不仅能帮助开发者更好地理解眼镜端与手机端的通讯机制，还能够为未来应用的扩展和优化奠定基础。

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！