AR 健身教练'形随心动':基于 Rokid CXR-M SDK 的实战开发
项目背景与架构设计
居家健身最大的痛点在于缺乏专业指导,动作不规范容易导致损伤,且低头看屏幕也破坏了沉浸感。利用 Rokid Glasses 轻量级 AR 眼镜的'抬头即见'特性,结合 CXR-M SDK 的 AI 场景与自定义页面能力,我们可以将虚拟教练投射到用户视野中,实现实时动作纠正与数据反馈。
系统采用分层架构设计,确保稳定性与可扩展性:
- 应用层:Android App,负责业务逻辑、UI 交互及计划管理。
- CXR-M SDK:核心通信层,处理设备连接、AI 场景调度及 AR 渲染。
- 硬件层:Rokid Glasses(YodaOS),执行传感器数据采集与 AR 显示。
整体技术链路为:应用层 → CXR-M SDK → Rokid Glasses → 硬件传感器。这种解耦设计让业务逻辑与硬件交互分离,后续扩展功能时只需调整上层模块。
SDK 环境配置与权限管理
Maven 依赖引入
CXR-M SDK 目前仅提供 Android 版本,需通过 Maven 在线管理。在 settings.gradle.kts 的 dependencyResolutionManagement 节点中添加仓库地址:
repositories {
maven { url = uri("https://maven.rokid.com/repository/maven-public/") }
}
在 build.gradle.kts 的 dependencies 中添加包依赖,注意 SDK 要求 minSdk >= 28:
implementation("com.rokid.cxr:client-m:1.0.1-20250812.080117-2")
权限声明与动态申请
SDK 运行需要网络、蓝牙及定位权限。在 AndroidManifest.xml 中声明最小权限集:
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />


