V3.1 文档与接口变更说明

本文档仅适用于 A3 软件版本 3.1.x。 目前文档开放功能较少，后续将会开放动作、表情播放接口、运控仿真等其他内容。

V3.1 文档更新说明

日期	更新内容	最新 AimDK 包名
2026-06-22	A3 开发指南 (v3.1) 文档发布	AimDK-A3-V3.1-0622
2026-06-22	文档错误描述纠正	AimDK-A3-V3.1-0622

V3.1 接口变更说明

更新日志中会列出相较于 V3.0 版本的各个接口变化，也会列出一些其他对二次开发有较大影响的其他修改，不兼容修改会使用加粗字体标出。

1. 二次开发程序部署

   • 添加有线连接机器人方式，用户可通过该方式将机器人连接到本地，以进行二次开发。详细连接步骤请参考有线连接机器人文档。

2. 运动控制部分

   • 添加机器人腰部控制topic接口
   • 添加机器人脖子控制topic接口

3. 麦克风管理部分

   • 添加内外置麦切换RPC接口
   • 添加麦克风状态获取RPC接口

4. 资源管理部分

   • 添加资源管理部分，用户可通过该模块创建、删除、获取、迁入、迁出资源，以满足机器人能力配置与内容定制需求。详细支持功能请参考资源管理部分文档。

5. 传感器数据部分

   • 添加imu、相机传感器数据topic接口

6. 系统状态获取部分

   • 添加bms电池状态获取RPC接口
   • 添加急停信号状态获取RPC接口

7. 交互二开部分

   • 新增人脸识别结果Topic接口使用

问题反馈渠道

如遇二次开发接口 bug，可通过如下渠道进行问题反馈

https://agirobot.feishu.cn/share/base/form/shrcnLP2tv9gzyrZ2tSDlm1Baif

注意

该渠道仅用于二次开发接口问题答疑或 bug 反馈，机器人本体故障或售后维修等请直接联系交付、运维、售后等相关团队。无关问题将不回复。 表单中请详细描述问题，最好给出可复现步骤，信息丰富、问题描述清晰的问题将会优先回复解决，含糊不清、笼统的问题优先级靠后且可能被忽略。 请认真填写各项信息，信息不一致或随意填写的工单将会被忽略。 单个工单请聚焦单个/类问题，请不要将多个问题混在一个工单中，这将大大延缓您的问题处理时间。