仙知小课堂丨仙知网络协议API使用教程（十五）

为方便用户更高效的使用移动机器人，仙知向用户开放机器人操作的相关 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 数据区： 见下表

响应示例

略

有关仙知

上海仙知机器人科技有限公司，是一家以移动机器人控制与调度为核心的高新技术企业。作为一站式移动机器人方案专家，仙知机器人掌握了具有自主知识产权的移动机器人核心技术，并在工业自动化领域内拥有丰富的项目经验。仙知机器人致力于服务各行业集成商，并为其提供包括移动机器人控制、调度与信息管理在内的一站式移动机器人解决方案。

目前，仙知机器人的产品、技术及解决方案已在汽车制造、家电制造、3C电子制造、半导体制造、食品烟草、电商仓储、安防巡检、商用服务、医疗教育等领域广泛应用。

仙知机器人积极践行企业使命—“让智能创造价值”，不断坚持技术创新，并以开放包容、合作共赢的姿态携手合作伙伴，最大程度地满足客户对产品、技术与解决方案的高品质追求，力争“成为机器人产业的创新者与引领者！”