PuGoing智能家居接入协议

介绍

管家机器人云平台对外提供智慧设备的添加、查找、状态查询以及控制等服务。第三方应用通过WSS协议(加密的WebSocket)、使用json数据格式与云平台进行通讯,就可完成对设备的操作与管理。同时,为了连接安全,所有请求请务必遵循云平台的签名规则。

PuGoing 智能家居接入协议

一.协议概述

socket地址:wss://xqwxmp.cspugoing.com

WSS协议(加密的WebSocket)

使用json数据格式与云平台进行通讯

h5接入方式

                                let ws = new WebSocket("wss://xqwxmp.cspugoing.com");
                                // 打开一个 web socket 地址为
                                ws.onopen = function()
                               {
                                  // Web Socket 已连接上,使用 send() 方法发送数据
                                  ws.send(JSON.stringify({
                                        "op":"mysys",
                                        "act":"auth",
                                        "date":{
                                            "appid":"XXXX",
                                            "appkey":"XXXXX"
                                          }
                                    }));
                                  alert("数据发送中...");
                               };
                                ws.onmessage = function (evt){
                                  //接收服务其返回的数据
                                  var received_msg = evt.data;
                                  alert("数据已接收...");
                               };

                               ws.onclose = function()
                               {
                                  // 关闭 websocket
                                  alert("连接已关闭...");
                               };
                            

h5接入详细说明http://www.runoob.com/html/html5-websocket.html

小程序接入

                            wx.connectSocket({
                            //建立与wss://xqwxmp.cspugoing.com的链接
                              url: 'wss://xqwxmp.cspugoing.com',
                              success:function(res){
                                //链接建立成功
                              },
                              fail:function(res){
                                //链接建立失败(res失败的原因)
                              }
                            })
                            wx.sendSocketMessage({data:JSON.string({
                                "op":"mysys",
                                "act":"auth",
                                "date":{
                                    "appid":"XXXX",
                                    "appkey":"XXXXX"
                                  }
                            })})
                            //发送JSON数据
                            wx.onSocketMessage(function(res){
                                //服务器返回的消息
                                //res.data返回的消息内容
                            })
                        

小程序接入详细说明https://developers.weixin.qq.com/miniprogram/dev/api/wx.sendSocketMessage.html

示例:

{
    "op":"mysys",
    "act":"auth",
    "date":{
        "appid":"XXXX",
        "appkey":"XXXXX"
      }
 }

正常响应:

{
    "ack":"1",
    "msg":{
        "token":"XXXXXXXXXXXXXXX"
      }
 }

参数协议

参数名 参数类型 参数说明 是否必传
op String 方法类别
act String 方法名

协议中的date列表

参数名 参数类型 参数说明 是否必传
appid String 联系管理员提供(用于获取token)
appkey String 联系管理员提供(用于获取token)