网页控制设备 Websocket API-Arduino中文社区 - Powered by Discuz! Archiver

机智宝 发表于 2017-1-23 16:00

网页控制设备 Websocket API

概述
JavaScript网页远程控制设备,是调用了机智云开放的Open API和WebSocket API来实现的。其中,Open API用到的接口有匿名登录用户、绑定设备和获取绑定设备列表。而WebSocket API上的用户登陆、设备上线下线通知、浏览器与云端的数据交互(数据透传)、心跳和非法消息通知。
http://club.gizwits.com/data/attachment/forum/201701/19/163215srijchlicgcwj5je.png


当设备已经是成功连接上云端,就可使用以下流程来控制设备了:
http://club.gizwits.com/data/attachment/forum/201701/19/163215wh87t6b69pyuhcyi.png


准备工作
调用OPEN API匿名登录用户和绑定设备

1.获取phone_id
phone_id 可以是手机的唯一识别码。或者您已经有了自己的用户系统,不希望用户再次注册一次机智云帐号,您也可以使用该接口,为您的每一个用户创建一个对应的机智云匿名帐号。这时,phone_id 可以是用户在您的系统中的唯一识别码。如在与微信应用做对接时,phone_id 可以设置成微信用户的 openid。

2.创建用户
http://swagger.gizwits.com/doc/index/openapi_apps#/用户管理/post_app_users


2.1.填写appid
http://club.gizwits.com/data/attachment/forum/201701/19/163215iy5h35var6666qa3.png

2.2.填写body
http://club.gizwits.com/data/attachment/forum/201701/19/163216o9yshl9lvy6lllz9.png


2.3.登录匿名用户,获取token
http://club.gizwits.com/data/attachment/forum/201701/19/163216re2kkidgs3o3gzfm.png

3.绑定设备
POST请求链接:
http://swagger.gizwits.com/doc/index/openapi_apps#/绑定管理/post_app_bind_mac

3.1.填写appid
http://club.gizwits.com/data/attachment/forum/201701/19/163216dj91c9a71b8cha4j.png


3.2.填写刚才匿名登录回调的token
http://club.gizwits.com/data/attachment/forum/201701/19/163216w5gsvvoqkrvp7p70.png

3.3.填写Timestamp、Signature和body
http://club.gizwits.com/data/attachment/forum/201701/19/163217kvzf3966t7pwd60z.png


备注:时间戳计算链接,http://tool.chinaz.com/Tools/unixtime.aspx
MD5计算链接,http://tool.oschina.net/encrypt?type=2,如下图:

http://club.gizwits.com/data/attachment/forum/201701/19/163217urawow74za9e4468.png


Websocket网页控制界面


1.websocket API封装起来的sdk
链接如下:
https://github.com/gizwits/gizwits-wechat-js-sdk


2.运行index.html

http://club.gizwits.com/data/attachment/forum/201701/19/163217mq4v14xdxvve1va9.png


3.Websocket网页控制界面https://gizwits.github.io/gizwits-wechat-js-sdk/v0.2.0.html,如下:



http://club.gizwits.com/data/attachment/forum/201701/19/163218aohk53grmqhgpdhm.png


控制设备分两种方式
1.V4版本的标准数据点协议
1.1.初始化Gizwits WS对象


上面使用的参数有:
| 参数 | 说明 | 数值 |
| ————- |:————-:| ————- |
|apiHost |机智云OpenApi域名 |api.gizwits.com|
|commType |标准数据点协议格式 |attrs_v4|
|wechatOpenId |微信用户OpenID(就是手机的iPhone_id)| String|
|gizwitsAppId |机智云平台应用标识 |String|


初始化,如下:

http://club.gizwits.com/data/attachment/forum/201701/19/163218aw2uy999ulv2yy65.png


1.2.获取绑定列表
如果该用户要获取绑定设备列表,先要确认该用户(就是该openid)是否有对要控制设备的已进行绑定了。

http://club.gizwits.com/data/attachment/forum/201701/19/163218uqj2jci8api1o817.png


1.3.创建Websocket连接
选择一个要进行控制的设备did,创建websocket连接

http://club.gizwits.com/data/attachment/forum/201701/19/163218ek2dpkpy4pdxpn0l.png


1.4.读取设备当前状态
选择已连接的设备,读取设备的当前状态

http://club.gizwits.com/data/attachment/forum/201701/19/163221ph464huvbhkltd4h.png


1.5.控制设备
选择已连接的设备,下发控制指令
如下发控制指令{“Swicth”:true},如下图:

http://club.gizwits.com/data/attachment/forum/201701/19/163221dq82f8z65ah6hbb5.png


控制模拟设备效果:
http://club.gizwits.com/data/attachment/forum/201701/19/163222itn15dgng5usws3u.png


2.V4版本的自定义格式协议
V4版本的自定义格式协议(就是无法数据点透传)


2.1.初始化Gizwits WS对象
上面用的的参数有:

参数说明数值
apiHost机智云OpenApi域名api.gizwits.com
commType标准数据点协议格式attrs_v4
wechatOpenId微信用户OpenID(就是手机的iPhone_id)String
gizwitsAppId机智云平台应用标识String



http://club.gizwits.com/data/attachment/forum/201701/19/163222xprhmx7rndh8yjrl.png


2.2.获取绑定列表
http://club.gizwits.com/data/attachment/forum/201701/19/163222fpdttn7it0di90e6.png

2.3创建websocket连接
选择一个要进行控制的设备did,创建websocket连接:

http://club.gizwits.com/data/attachment/forum/201701/19/163222i9xffujf0utz9gf0.png


2.4.读取设备的当前状态
选择已连接的设备,读取设备的当前状态:

http://club.gizwits.com/data/attachment/forum/201701/19/163224vy4sm4f45pkrzcrk.png


2.5.下发控制指令
选择已连接的设备,下发的控制指令: (注意:下发数据的格式为十进制的,每个位端的表示为0,0,0,3为header、9为len、0为flag、0,144为cmd、1为action、0,1,2,3,4为业务指令),如下:

http://club.gizwits.com/data/attachment/forum/201701/19/163225fk11d1sgd11zppxx.png


模拟mcu收到命令,如下:
FF FF 00 0B 03 1E 00 00 01 00 01 02 03 04 37

http://club.gizwits.com/data/attachment/forum/201701/19/163225yojj482iqx4cujqc.png
页: [1]
查看完整版本: 网页控制设备 Websocket API