Skip to content

faq.md

Latest commit

 

History

History
82 lines (52 loc) · 2.42 KB

faq.md

File metadata and controls

82 lines (52 loc) · 2.42 KB
Raw

常见问题

连接问题

Q: 无法连接到机器人？

A: 请检查以下项：

  1. 确保手机/平板与机器人处于同一局域网
  2. 确认机器人 IP 地址和端口配置正确
  3. 检查防火墙是否阻挡了 UDP 端口
  4. 确认机器人已开机并处于可连接状态

Q: 连接成功后很快断开？

A: 可能是网络不稳定或心跳超时。检查：

  1. 网络信号强度
  2. 是否有其他设备或进程占用了相同 IP和端口
  3. 心跳间隔是否正常（SDK 默认 200ms）

控制问题

Q: 发送摇杆指令后机器人没有反应？

A: 请检查：

  1. 是否已正确设置 axisDataProvider
  2. 机器人是否处于手动模式
  3. RobotSdkManager.axisDataProvider 是否返回了非 null 的 AxisData
  4. RobotStatesManager.controlEnable() 是否返回 true

Q: 切换运动模式失败？

A: 部分模式切换需要满足前置条件（如静止状态）。建议：

  1. 确保机器人已停止运动
  2. 检查当前模式是否支持目标模式切换
  3. 查看 RobotErrorManager.errorListLive 是否有相关错误码

手柄问题

Q: 手柄无法识别？

A: ControllerSDK 仅支持山猫 M20 标配的云卓 G20 手柄。请确认：

  1. 手柄型号是否为云卓 G20
  2. USB 线是否连接正常
  3. 是否已授予 USB 权限
  4. 是否已正确调用 ControllerManager.init(context)

编译问题

Q: 编译 AAR 时失败？

A: 请检查：

  1. 是否已正确配置 JDK 17+ 和 Android SDK API 33+
  2. Gradle 版本是否为 8.x
  3. settings.gradle 中是否包含了所有必需的模块（RobotProtocol、RobotConnectUDP、RobotSDK）
  4. ControllerSDK 编译是否缺少 rcsdk-v1.9.1.aar 依赖（需从云卓官方获取并放入 ControllerSDK/libs/）

Q: 引入 AAR 后 App 编译报错？

A: 请检查：

  1. AAR 文件是否已正确放入 libs/ 目录
  2. build.gradle 中是否配置了 implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
  3. 是否缺少 AndroidX Lifecycle 依赖（androidx.lifecycle:lifecycle-livedata-ktx）
  4. ControllerSDK 是否缺少 rcsdk-v1.9.1.aar 依赖

协议问题

Q: 自定义协议发送后收不到响应？

A: 请检查：

  1. Type 和 Command 是否与机器人端约定一致
  2. onRawResponseListener 是否在连接建立前已设置
  3. 响应是否在 IO 线程解析，更新 UI 是否已切至主线程
  4. 是否正确处理了设备状态报告的 Type/Command 组合