为方便用户更高效的使用移动机器人,仙知向用户开放机器人操作的相关 API。
仙知小课堂
之前分别介绍了确定定位正确、取消重定位、开环运动、切换载入的地图等,本期将介绍“机器人导航API”,包括“API列表”、“暂停当前导航”、“继续当前导航”及“取消当前导航”:
API列表
请求
注: 所有指令不能同时进行
响应
机器人导航 API 的会立即响应给客户端,不会等待机器人执行导航。若 ret_code 不存在或为 0,说明导航将被执行,但并不表示导航已经执行完毕了,用户需要通过机器人状态 API (1020) 查询导航的状态。机器人某一时刻只能有一个导航,新的导航指令将会打断之前的导航。
暂停当前导航
请求
编号: 3001 (0x0BB9)
名称: robot_task_pause_req
描述: 暂停当前导航
JSON 数据区: 无
请求示例
响应
编号: 13001 (0x32C9)
名称: robot_task_pause_res
描述: 暂停当前导航的响应
JSON 数据区: 见下表
响应示例
略
继续当前导航
请求
编号: 3001 (0x0BB9)
名称: robot_task_pause_req
描述: 暂停当前导航
JSON 数据区: 无
请求示例
响应
编号: 13001 (0x32C9)
名称: robot_task_pause_res
描述: 暂停当前导航的响应
JSON 数据区: 见下表
响应示例
略
取消当前导航
请求
编号: 3003 (0x0BBB)
名称: robot_task_cancel_req
描述: 取消当前导航
JSON 数据区: 无
请求示例
响应
编号: 13003 (0x32CB)
名称: robot_task_cancel_res
描述: 取消当前导航的响应
JSON 数据区: 见下表
响应示例
略
(转载)