Rokid CXR-M SDK 入门:AR 远程协作系统开发环境配置

以下是配置开发环境的完整流程,基于 Android 平台(推荐 Android Studio):

1. 硬件准备
  • Rokid CXR-M AR 眼镜(需开启开发者模式)
  • 开发主机:Windows 10+/macOS 10.15+(推荐 16GB RAM)
  • USB 3.0 数据线(用于设备调试)
  • 稳定的网络环境(用于远程协作功能测试)
2. 软件依赖安装
# 安装基础工具 (Windows 示例)
choco install adb git jdk17 -y
# macOS 使用 brew
brew install --cask android-studio

3. 配置 Android 开发环境
  1. 下载并安装 Android Studio
  2. 配置 SDK 组件:
    • SDK Platform: Android 11.0 (API 30)
    • NDK: 23.1.7779620
    • CMake: 3.22.1
  3. 环境变量配置:
    # Windows
    setx ANDROID_HOME "C:\Android\Sdk"
    setx PATH "%PATH%;%ANDROID_HOME%\platform-tools"
    
    # macOS/Linux
    echo 'export ANDROID_HOME="$HOME/Android/Sdk"' >> ~/.zshrc
    echo 'export PATH="$PATH:$ANDROID_HOME/platform-tools"' >> ~/.zshrc
    

4. 集成 Rokid CXR-M SDK
  1. 下载 SDK 包(从 Rokid 开发者平台获取 cxrm-sdk-android-{version}.aar
  2. 在项目中配置依赖:
    // app/build.gradle
    dependencies {
        implementation files("libs/cxrm-sdk-android-1.5.3.aar")
        implementation 'com.rokid.glass:ui-kit:2.0.1'  // UI组件库
    }
    

  3. 添加权限声明至 AndroidManifest.xml
    <uses-permission android:name="com.rokid.glass.permission.HARDWARE" />
    <uses-permission android:name="android.permission.CAMERA" />
    <uses-feature android:name="android.hardware.camera.ar" />
    

5. 设备连接与调试
  1. 在眼镜中启用开发者模式:
    设置 → 关于设备 → 连续点击版本号 7 次
  2. USB 调试授权:
    adb devices  # 查看设备ID
    adb -s <device_id> tcpip 5555  # 启用网络调试
    

  3. 运行示例代码验证:
    // 初始化AR会话
    CXRMArSession arSession = new CXRMArSession(this);
    arSession.setRemoteAssistantEnabled(true);  // 启用远程协作
    

6. 常见问题解决
问题现象解决方案
SDK 初始化失败检查 minSdkVersion ≥ 24
摄像头无法启动确认已授予相机权限
远程协作连接超时验证网络防火墙是否放行 UDP 端口 5060
画面渲染异常更新 GPU 驱动至最新版本

重要提示

  • 开发时保持眼镜电量 > 50%
  • 实时参考 Rokid 官方文档
  • 使用 adb logcat -s CXRM 过滤 SDK 日志

完成上述步骤后,即可开始构建 AR 远程协作应用,下一步建议尝试实现实时标注共享功能。

更多推荐