机智云微信 AirKiss2.0 开发指南

Genius · 发表于 2016-8-30 14:18:11

本帖最后由 Genius 于 2016-8-30 14:23 编辑

（机智云微信 AirKiss2.0 开发指南）
目录
1. 前期准备1.1. site 上创建项目
1.2. 企业 API 申请（可选）
1.3. 微信官网申请发布产品
1.4. 生成 wifi 模块固件
2. 软件端
2.1. 不需要开发实现的功能（！）
2.2. 微信端需实现功能
2.2.1. 获取微信 access_token
2.2.2. 匿名注册机智云账号
2.2.3. 设备配网和授权（！）
2.2.4. 绑定设备流程
2.2.5. 解绑设备流程
2.2.6. 控制设备流程
2.2.7. 关于曲线图数据

1. 前期准备
1.1. site 上创建项目
创建好 site 项目和 APPID 并做好关联。
1.2. 企业 API 申请（可选）
如果业务云需要实时接收设备数据或调用企业 API 则需要申请开通。
企业 API：接入机智云后可找相关人员获取。

1.3. 微信官网申请发布产品
创建产品，第一页需要勾上的选项为：平台基础接入方案、 WIFI、每种型号唯一的二维
码、微信配网、不使用加密（注：由于模块不支持加密，如果选了加密方式会配置不了模块入网）。
第二页需要勾上的选项为：连接能力、微信配网、局域网发现。
获取原始 ID、产品 ID、 APPID、秘钥用于调用微信接口。
下载产品二维码，用于 Airkiss 配网和局域网发现设备。
在公众号基本配置中设置好业务云服务器地址等信息。

1.4. 生成 wifi 模块固件
从微信公众平台获取原始 ID，用于生成该项目固件，并烧录到模块。

2. 软件端

2.1. 不需要开发实现的功能（！）
微信 Airkiss 配网、局域网发现。
微信产品创建好后会有生成产品二维码，该二维码自带 Airkiss 配网和局域网发现功能。

2.2. 微信端需实现功能

2.2.1. 获取微信 access_token
https://mp.weixin.qq.com/wiki/11/0e4b294685f817b95cbed85ba5e82b8f.html
（注： access_token 有效期为 2 小时，需要定时获取，只有最新的 token 有效）。

2.2.2. 匿名注册机智云账号
每个微信用户都需要先匿名注册机智云账号（注： phone_id 可以使用微信的 openid，
不同的账号不要用同一个）。

2.2.3. 设备配网和授权（！）
微信扫描产品二维码后，点击配置设备上网，输入 wifi 密码点击确定进行配网。
设备授权方法 1：
单独开发一个上传 execl 表格的网页界面，给用户把需要授权的 mac 地址列表上传到服
务器，然后对每个 mac 地址进行微信授权。
设备授权方法 2（推荐）：
使用机智云规则引擎，当设备上线后会推送上线信息到业务云，业务云拿到上线设备的
mac 地址后在数据库中判断是否已授权，如果未授权就调用微信授权接口。
两种方法最好都要有一个界面给用户查询某个 mac 地址是否已授权。
http://iot.weixin.qq.com/wiki/new/index.html?page=3-4-5

2.2.4. 绑定设备流程
微信扫描产品二维码后，点击绑定设备，微信服务器会推送绑定事件到业务云，业务云
从绑定事件中获取设备 id(授权时填 MAC 地址)，然后调用机智云绑定设备接口。（注：设备
需要先授权才能被发现）

获取设备列表（如不想返回已失效设备 show_disabled 的值设置为 0）。

2.2.5. 解绑设备流程
设备解绑需在两个地方实现。
地方 1：
在公众号内的设备列表中进行解绑设备，先调用机智云的解绑设备接口，成功后再调用
微信解绑接口。

地方 2：
在微信的设置-设备中进行解绑设备，用户解绑设备后微信服务器会推送解绑事件给业
务云，业务云再调用机智云的解除绑定接口。
微信解绑： http://iot.weixin.qq.com/wiki/new/index.html?page=3-4-7

2.2.6. 控制设备流程
数据收发用 WebSocket （如果使用 OpenAPI 发送， Noti 接收的方法，界面不会实时刷新，
Noti 断开了也会导致整个界面死掉，不建议使用）
WebSocket 手册：
http://site.gizwits.com/zh-cn/document/openplatform/i_051_websocket_api/（旧）
http://docs.gizwits.com/hc/kb/article/144497（新）

2.2.7. 关于曲线图数据
简单的曲线图数据可通过云端的聚合 API 获取，要通过逻辑运算的，也可以通过编写解
析脚本的形式在机智云进行运算，大大减少了业务云的负担和开发成本（注：聚合 API 需要
单独开通，注意非企业 API 的聚合接口）