基于微信公众平台的智能硬件/智能设备APP开发详解
智能硬件APP开发，通常分三种形式， Andriod、ios、H5，而常见的H5开发常见的又属 APICloud SDK、微信应用开发。有的开发者，本身擅长移动端语言开发、或者是会使用常见的开源框架，便选择写原生APP或者是混合APP下面带大家来看看，如何为智能硬件写微信应用开发。
1、需准备的工具：
[*]公众号的原始ID
[*]设备的二维码
[*]一台设备
注意，不能申请订阅号（不支持微信认证）。我们将申请一个服务号，并且完成认证操作，然后才能开启“设备功能”模块，最后添加一个产品。2、设备绑定3、业务服务器的搭建——————详细概述————————1、准备好工具后：
[*]公众号的原始ID
[*]设备的二维码
[*]一台设备
你得有台设备吧？
微信接入前，需保证，设备能正常地与机智云进行通讯，设备的具体开发流程如下。http://docs.gizwits.com/assets/zh-cn/WechatDev/wechat_02.png注意，在WIFI模块中，写入AirKiss时，需要配置公众号的原始ID。也就说，除了将机智云的product_key写入MCU以外，还需要将公众号原始ID写入WIFI固件中。关于固件的烧录，厂商或者小伙伴们如有困难，可以寻求机智云 · 客服MM的帮助。设备二维码微信客户端APP可以通过扫描二维码添加设备。设备二维码相关信息请点击这里。设置内容如下：http://docs.gizwits.com/assets/zh-cn/WechatDev/wechat_03.png设备授权设备不但要在WIFI固件中写入公众号原始ID(注意，不是APPID)，还要将所有设备的Mac地址，登记到微信服务器上。一开始，微信只给你100个配额，也就是说，你只能授权100个设备。授权的方法，就是向微信的接口，发送一次请求，具体请看微信文档-设备授权。很多小伙伴反应，授权经常失败，我们这里给出一组基于WIFI通讯的示例，大家可以参考：http://docs.gizwits.com/assets/zh-cn/WechatDev/wechat_04.png注意：12位xxxxxxxxxxxx，代表设备的Mac地址，id是指设备ID，也就是机智云的did。但因为设备必须在上线后，机智云才会分配一个did，所以，我们并无法预知did是什么。通常的做法是：将id和mac，都设置为设备的Mac值。auth_key可以不填，设置为空字符串，但不能没有这个字段。op_type为0时，表示添加一台设备，后面需要跟着product_id字段(产品ID，在公众号的“设备功能”中，添加产品后，会有这个id)。op_type为1时，表示更新一台设备，此时不需要product_id字段。批量授权时，记得更新顶部的：device_num。这样，我们硬件（设备）层面的准备工作，就完成啦。阶段性成果好了，到这步，你可以稍微的奖励一下自己，享受一下阶段性的成果啦!打开你的微信（确保是wifi链接状态），扫一扫你的产品二维码。http://docs.gizwits.com/assets/zh-cn/WechatDev/wechat_05.jpg下面有两个按钮，绿色的按钮，是启动微信的AirKiss，将WIFI的账号密码，发送给设备的WIFI模块。部分设备需要启动匹配模式，才能配置上网。一般先启动设备的匹配模式，再使用微信的配置功能。配置完成后，会自动跳转到设备搜索界面。在搜索界面，如果前面准备工作到位了，你一定能发现设备（不管是否绑定过）。点击发现的设备，然后绑定。微信会自动跳转到公众号页面。然后，你可以在微信的设置页面中，发现多了一个项目：设备。当然，上面的操作，只是实现绑定操作。下面的教程将介绍如何监控设备的数据点。简化操作的SDK为了简化开发者的操作，我们将一些必要的API封装成了两个SDK: Java-SDK 以及 js-SDK。它们分别用于后台和前端页面，各自封装了机智云的OpenAPI 以及 WebSocket。这两个SDK，将大大的简化了API的操作，帮我们接管了token和用户管理，我们只需要调用相关方法，即可实现设备的绑定和解绑。SDK，可以在本文的附件中下载。业务服务器的搭建设备没问题了，我们现在需要的是，操控设备本身的功能。由于设备已经与机智云正常的通讯，因此，对设备的操作，其实就是如何与机智云交互。机智云设备绑定现在，用户已经在微信中绑定了设备，他希望看到，设备在线状态。怎么办?我们使用微信的OpenId，作为唯一标识，生成匿名用户。什么时候注册匿名用户呢？微信绑定设备时候，将推送一条设备绑定事件消息到我们的业务服务器。我们在这个时候，将同时完成注册匿名用户，以及绑定用户/设备的操作。http://docs.gizwits.com/assets/zh-cn/WechatDev/wechat_06.jpg微信在绑定时，发送这么一条事件消息：http://docs.gizwits.com/assets/zh-cn/WechatDev/wechat_6.5.png我们需要的是其中的OpenID和Mac，然后我们调用机智云的Java-SDK：
DeviceInfo deviceInfo = OpenApi.bindDevice(
wechatOpenId,
gizwitsAppId,
gizwitsProductKey,
gizwitsProductSecret,
mac,
deviceAlias,
deviceRemark)
参数名类型说明
wechatOpenIdString微信中的OpenId，也就是机智云中注册的匿名用户
gizwitsAppIdString机智云产品所绑定的APP的id
gizwitsProductKeyString机智云的产品key
gizwitsProductSecretString机智云的产品Secret
macString设备的Mac地址
deviceAliasString设备的别名
deviceRemarkString设备的备注
这个方法，一次性解决了两个问题：注册匿名用户，绑定用户/设备。相对的，也要设定很多参数。所有的参数都是String类型。其中deviceAlias（设备别名）以及deviceRemark（设备备注）都可以填空字符串“”。gizwitsProductKey就是你在开发者中心创建的产品。http://docs.gizwits.com/assets/zh-cn/WechatDev/wechat_07.jpg而gizwitsProductSecret，则是该产品对应的密匙，在产品的详细信息中可以找到。http://docs.gizwits.com/assets/zh-cn/WechatDev/wechat_08.jpggizwitsAppId是机智云中，APP的Id。由于一个产品，可能是多个APP操作的，比如iOS的APP，Android的APP，网站Web应用，甚至微信这样的轻应用，都算是一个APP。因此，在创建产品后，你还可以在为产品绑定一个或多个APP。这里的gizwitsAppId就是我们所绑定APP的Id了。注意，APP必须绑定在产品上，才能使用。当你调用该方法，就能实现注册匿名用户，已经将用户/设备绑定的操作了。是不是很方便呢？当然，为了方便起见，你还可以进一步封装这个SDK。这里就不展开了。机智云设备解绑解绑操作也是类似的逻辑。当微信推送一条解绑事件消息，我们就会进行解绑操作。同样调用SDK：
Boolean isSuccess = OpenApi.unbindDevice(wechatOpenId, gizwitsAppId, gizwitsDid);
参数名属性说明
WechatOpenIdString微信中的OpenId，也就是机智云中注册的匿名用户
gizwitsAppIdString机智云产品所绑定的APP的id
获知设备的在线状态
Boolean isOnline = OpenApi.getDeviceOnlineStatus(wechatOpenId, gizwitsAppId, gizwitsDid);
参数名属性说明
wechatOpenIdString微信中的OpenId，也就是机智云中注册的匿名用户
gizwitsAppIdString机智云产品所绑定的APP的id
gizwitsDidString机智云中的设备ID，对应Mac，设备重置时会重新注册
代码样例http://docs.gizwits.com/assets/zh-cn/WechatDev/wechat_09.png请注意，在服务器部署的时候，部分开发者会发现部署失败。tomcat中的catalina日志会报错：
javax.net.ssl.SSLException:java.security.ProviderException:java.security.KeyException
这是因为SDK中采用了Https的方式进行访问。解决方法是：升级服务器环境中的库：nss。微信页面操作设备好了，我们现在已经绑定了设备，并且也能知道设备的在线的状态了。但是具体如何操作我们的设备？一个良好的体验，当然是具有交互页面的。
下面我们就一步步的搭建一个交互页面，来监控我们的设备吧！获取OpenId用户点击页面，我们如何知道是哪个用户呢？我们需要获取当前用户的OpenId来识别时哪个用户。如何获取呢？详细可以看微信的官方文档。简单的来说，我们向微信的服务器发送授权请求，微信会判断我们请求的URL，是否是授权的域名，如果验证通过，就会转发到我们的URL，并且带上几个参数。其中最重要的参数，是code，我们通过Code可以获取OpenId。然后，我们再将OpenId返回到页面中。http://docs.gizwits.com/assets/zh-cn/WechatDev/wechat_10.png连接机智云的WebSocket对于访问机智云的WebSocket，我们已经封装成了一个JS-SDK。大家只需要引入到页面即可。初始化gizwits服务首先是，构建一个gizwits服务：http://docs.gizwits.com/assets/zh-cn/WechatDev/wechat_11.png这个gizwits服务，会负责接下来所有的操作，包括：连接设备，读取设备的数据点，操作设备等。
参数名属性说明
ApiHostStringwebsocket的目标API域名
CommTypeString协议格式：custom(自定义协议); attrs_v4(标准数据点协议)
wechatOpenIdString当前访问的微信用户OpenId
GizwitsAppIdString机智云产品所绑定的APP的id
当然，此时gizwits服务，并没有运行起来，我们还需要初始化操作。但在操作之前，我们可以选择配置一个回调函数，它会在初始化结束后，自动运行。http://docs.gizwits.com/assets/zh-cn/WechatDev/wechat_12.png当执行gizwits.init()的时候，就会初始化gizwits服务，并且将匿名用户OpenId绑定的所有设备，放置在回调函数的devices中。而我们要做的操作，都应该写在回调函数gizwits.onInit里面。devices列表中的每个设备，都会有六个属性，分别是product_key(产品的Key), dev_alias(设备别名），did(设备ID)，mac，is_online(在线状态）, remark(设备备注)。我们可以根据情况来使用。设备列表http://docs.gizwits.com/assets/zh-cn/WechatDev/wechat_13.png上面的操作中，我们已经获取到了设备列表。一般来说，客户可能拥有多个设备，因此，我们在这一步，就可以罗列一个设备列表，由用户自己决定，来操作哪台设备。连接设备想要操作具体哪台设备，我们就去连接哪台设备：gizwits.connect(did)。当然连接成功后，也有一个回调函数：gizwits.onConnected。此回调函数没有传入值。注意，连接设备之前，必须先初始化。初始化和连接设备，并非同步操作，因此，如果只是简单的先后执行，可能会出错。因此，建议可以将连接设备的操作，放在初始化的回调函数中，保证执行的先后关系。连接成功后，我们就可以收到设备上报的数据了。上报的数据通过回调函数：gizwits.onReceivedAttrs。该回调函数会有一个回调值（参数），这个回调值的格式如下：http://docs.gizwits.com/assets/zh-cn/WechatDev/wechat_14.png上面的操作中，我们已经获取到了设备列表。一般来说，客户可能拥有多个设备，因此，我们在这一步，就可以罗列一个设备列表，由用户自己决定，来操作哪台设备。连接设备想要操作具体哪台设备，我们就去连接哪台设备：gizwits.connect(did)。当然连接成功后，也有一个回调函数：gizwits.onConnected。此回调函数没有传入值。注意，连接设备之前，必须先初始化。初始化和连接设备，并非同步操作，因此，如果只是简单的先后执行，可能会出错。因此，建议可以将连接设备的操作，放在初始化的回调函数中，保证执行的先后关系。连接成功后，我们就可以收到设备上报的数据了。上报的数据通过回调函数：gizwits.onReceivedAttrs。该回调函数会有一个回调值（参数），这个回调值的格式如下：http://docs.gizwits.com/assets/zh-cn/WechatDev/wechat_15.png手动读取：设备数据点获取设备的数据点，也很简单，只需调用gizwits.read()方法，不需要任何参数。调用此方法，可以马上获取一次，同样，数据也是通过回调函数 gizwits.onReceivedAttrs，或者gizwits.onReceivedRaw来获取。连接错误当websocket连接错误时，会调用gizwits.onError函数，如有需要，可以重写该函数；回调值是错误信息：
gizwits.onError = function(value){
console.log("error!!!!:::::", value.toString());
}
设备上下线当设备发生上线，或者下线的事件时，gizwits服务，会调用gizwits.onOnlineStatusChanged 回调函数.回调值有两个参数：did和在线状态(is_online)。
gizwits.onOnlineStatusChanged = function(value) {
alert("设备上下线通知，did=", value.did);
alert("设备上下线通知，is_online=", value.is_online);
}
控制设备最后是，设备的远程控制。远程控制的调用方法，如果commType=custom，则使用gizwitsws.send(command)方法，如果commType=attrs_v4，则使用gizwitsws.write(command)方法。远程控制的值，如果commType=custom，请输入p0，例如[,,…]；如果commType=attrs_v4，请输入datapoints，例如{“power”:true}。下面是远程控制RBG灯的代码样例：
var command = '{"LED_R": 0, "LED_G": 0, "LED_B": 0}';
gizwits.write(did, JSON.parse(command));
当然，使用控制设备的前提是，我们已经连接上了一台设备。结语至此，我们已经实现了微信接入的核心部分。在此教程中，Java-SDK与js-SDK为我们带来了很大的，我们几乎不用关心如何调用机智云的API和websocket，而是直接调用SDK的方法就可以了。最后，希望大家能多多反馈意见，为更加便捷的开发贡献一份力量。
页:
[1]