使用需知

要使用此文档必需先完成以下步骤：

步骤	操作流程
1	使用“你掌控”小程序注册一个普通用户新账号，并将账号的信息补充完整
2	把账号信息提供给我们销售人员或淘宝客服
3	由销售人员或淘宝客服生成接口要用的userKey，请保管好此信息，并不要外发给其他人

说明

• 只支持设备固件版本 > 20.7 的设备，脱机任务需要21.8或更高版本的固件
• 客户端只需要通过鉴权信息与userKey即可进行通讯，中间件为rabbitMQ。
• 假设userKey为 AAAABBBBCCCCDDDD， 客户端需要订阅 queueAAAABBBBCCCCDDDD 的队列消息
• 客户端需要向服务端发送数据时，向名为 exchangeniren 的交换器进行发送
• 在平时没有通讯的时候，每分钟要发一次心跳，具体规则请查看心跳功能。
• 命令在传输过程中以JSON格式进行传输，具体结构如下所示:

  {
    "userKey":"AAAAABBBBBCCCCCDDDDD", #这里为上面说到的开发者key，用于识别开发者身份
    "msgCode":3,
    "info":null 
  }

字段名	数据类型	必选	说明
userKey	String	是	开发者的userKey，由我司销售人员或淘宝客服提供
msgCode	int	是	消息码，指示当前通讯的功能
info	String	否	可能是一个字符串，也可能是一个json字符串，也可能为null，与msgCode相关，根据msgCode进行解析，具体查看相应的功能

• 在后面的指令中，userKey的值均使用 AAAAABBBBBCCCCCDDDDD ，但开发者应该使用自己的userKey
• 文档后面的客户端均指开发者端，服务端均指你掌控平台
• 开发中可能会用到的辅助工具

JSON格式化工具