微信硬件平台
概述
微信硬件平台介绍
微信硬件平台是微信在连接人、连接企业和服务之后，推出的连接硬件设备的物联网解决方案。微信硬件平台以微信用户ID体系为基础，以用户价值为依归，立志于打造用户和设备厂家共赢的物联平台，实现人，设备、厂家的互联互通。
通过微信硬件平台提供的AirSync、AirKiss、硬件JSAPI、直连SDK等技术，蓝牙设备、Wi-Fi设备与移动网络设备等智能设备都能便捷地实现与微信之间的互联和通讯，用户可以通过公众号查看和控制自己的手环、电视、空调和其它智能家电等。
智能设备能够通过各种方式与微信绑定，如：扫描设备二维码、调用JSAPI与用户建立对应关系等。硬件设备厂商可以因此准确地了解到设备用户的相关信息。
此外，微信硬件平台向智能设备提供了多种增值服务，包括社交元素、模式识别技术等，设备厂家可为用户提供更多的服务，以提升用户黏性。
微信硬件平台的优势
微信硬件平台为设备提供直连数据通道，设备可以通过直连SDK直接接入微信硬件服务器，将大大减轻设备厂家接入难度与研发投入负担、缩短产品上市周期。
微信拥有完善的ID体系。接入微信硬件平台即意味着第三方设备能够使用微信的各类ID体系。
微信为第三方提供了轻应用形式的开发方案。结合标准微信JSAPI和微信硬件平台特有的API，硬件厂商可以快速构建自己的轻应用。
微信拥有数量庞大的活跃用户。有利于硬件设备口碑传播的同时，App推广的成本也将大幅降低。
微信硬件平台为第三方提供了O2O的便捷。设备厂商可以在公众号上建立微信小店，根据设备运行情况，定期提供配件和耗材的购买服务，为用户提供更好的服务体验。
接入方案介绍
设备接入方案即设备接入微信硬件平台使用的数据传输方案，目前包含平台基础接入方案与微信硬件云标准接入方案。
-
1.平台基础接入方案
适用对象：
（1）拥有后台服务器的设备厂商
（2）希望在公众号体系内独立实现设备相关功能（即不需要微信硬件平台提供的产品标准能力）
（3）希望设备可以收发微信消息（图片／音乐／文件／地理位置等）微信硬件平台是基于微信公众平台基础构建的，微信公众平台基础技术架构如图1所示。
图1 微信公众平台技术架构公众号运营分为编辑模式和开发模式。
在编辑模式下，公众号运营者登录微信公众号管理页面，通过手动方式编辑消息和管理用户。
在开发模式下，运营者可以获得更多高级的接口功能（包括设备功能），通过编写消息接口程序，让第三方服务器自动管理用户和消息。
图2 微信硬件平台基础接入方案技术架构在这个基础架构里，设备厂家必须有自己的服务器，通过硬件平台基础消息接口，接收设备和用户消息，提供设备服务。
-
2.微信硬件云标准接入方案
适用对象：希望通过微信硬件平台提供的产品标准能力集定义设备数据，实现设备数据互联互通的设备。（1）设备直连微信硬件云通道
微信硬件平台为设备提供直连数据通道，设备可以通过直连SDK直接接入微信硬件服务器，打通设备到云端的通道。框架如图3所示：
图3 设备直连微信硬件云通道在直连方案中，微信硬件平台将提供设备信息管理、绑定关系存储、设备权限管理、设备固件版本控制、设备数据统计、数据登录鉴权、状态更新、固件更新等服务。
具体描述：请参照文档 新增直连数据通道
（2）设备商云连接微信硬件云通道
设备连接厂商服务器后，可通过设备openAPI与微信硬件云对接。框架如图4所示：
图4 设备商云连接微信硬件云通道目前，设备厂商可通过微信硬件平台提供的开发模式接入设备。整体技术架构如图5所示：
图5 微信硬件平台开发模式技术架构
接入流程
认证服务号
开通设备功能
开发
审核并发售
平台基础接入流程
-
1.申请认证公众号&开通设备功能
1.1 公众号申请
1.2登录公众平台，点击左边功能栏的"添加功能插件"，选择"设备功能"。
点击"开通"，阅读并同意《微信公众平台微信互联设备功能服务协议》。
-
2.添加产品
进行产品开发前，第三方需要在"公众平台-设备功能"内添加接入的产品。一个公众号允许添加多种产品（比如可以添加N款音箱和N款车机），每种添加成功的产品都默认获得微信硬件平台分配的100个设备授权配额。
2.1进入"设备功能"，点击"添加产品"
2.2产品基础资料登记
其中，接入方案中勾选“平台基础接入方案”。“平台基础接入方案”即：
2.3产品能力登记
-
3.产品开发调试
3.1服务器配置
厂商可以选择配置新的服务器，用于接收硬件产生的消息和事件，如“耗电提醒”等。
该服务器配置对于“平台基础接入方案”并非必需，若厂商配置了服务器，则所有有关硬件的消息（如绑定事件、耗电提醒等）会发送到该服务器URL中，而其余公众号有关消息（如关注事件、客服消息等）依然发送到公众号配置的服务器URL中。
若厂商未配置服务器，则所有消息（包括硬件消息和公众号消息）都会发送到原有公众号配置的服务器URL中。
具体配置方式如下：
3.1.1登录公众平台，点击“设备功能”，进入“设置”页面
3.1.2点击“修改配置”按钮，进入服务器配置填写页面。填写服务器地址（URL）、Token和EncodingAESKey。其中URL是开发者用来接收微信互联设备消息和事件的接口URL。Token可由开发者任意填写，用作生成签名（该Token会和接口URL中包含的Token进行对比，从而验证安全性）。EncodingAESKey由开发者填写或随机生成，将用作消息体加解密密钥。
3.1.3选择消息加密方式：明文模式、兼容模式和安全模式。模式的选择与服务器配置在提交后会立即生效，请开发者谨慎填写及选择。加解密方式的默认状态为明文模式，选择兼容模式和安全模式需提前配置好相关加解密代码，详情请参考消息体签名及解密部分的文档。
3.2后台接口调试
3.2.1设备授权
硬件设备接入微信硬件平台首先要进行设备授权。查看 设备授权新接口获取到的二维码即为一机一码，设备厂商利用二维码生成器把获取到的二维码串生成为二维码，用户扫描该二维码后，关注厂商公众号，即可绑定设备注意：设备授权时必须填上product_id
3.2.2接收设备绑定/解绑事件
用户扫描一机一码，关注厂商公众号，即可绑定设备，此时厂商会接收到微信硬件平台推送的绑定事件。绑定关系即deviceid（设备id）与openid（用户id）的关系。若用户解绑设备，厂商会收到解绑事件。
具体接口: http://iot.weixin.qq.com/wiki/document-2_2.html
3.2.3其他API查看 平台基础消息接口
微信硬件云标准接入流程 —— 设备直连微信硬件云通道
-
1.申请认证公众号&开通设备功能
1.1公众号申请
1.2登录公众平台，点击左边功能栏的"添加功能插件"，选择"设备功能"。
点击"开通"，阅读并同意《微信公众平台微信互联设备功能服务协议》。
-
2.添加产品
进行产品开发前，第三方需要在"公众平台-设备功能"内添加接入的产品。一个公众号允许添加多种产品（比如可以添加N款音箱和N款车机），每种添加成功的产品都默认获得微信硬件平台分配的100个设备授权配额。
2.1进入"设备功能"，点击"添加产品"
2.2产品基础资料登记
其中，接入方案中勾选“微信硬件云标准接入方案”——“设备直连微信硬件云通道”。“设备直连微信硬件云通道”即：
SDK开发部分后续具体介绍。
2.3产品能力登记
-
3.产品开发调试
3.1服务器配置
为了接收到微信发送的设备消息（如绑定事件、耗电提醒等），设备厂商需要在mp平台上配置接收微信硬件消息的URL。配置启用后，微信转发的消息将会按照OpenAPI的接口定义以Json格式推送到开发者配置URL。
3.1.1登录公众平台，点击“设备功能”，进入“设置”页面
3.1.2点击“修改配置”按钮，进入服务器配置填写页面。填写服务器地址（URL）、Token和EncodingAESKey。其中URL是开发者用来接收微信互联设备消息和事件的接口URL。Token可由开发者任意填写，用作生成签名（该Token会和接口URL中包含的Token进行对比，从而验证安全性）。EncodingAESKey由开发者填写或随机生成，将用作消息体加解密密钥。
3.1.3选择消息加密方式：明文模式、兼容模式和安全模式。模式的选择与服务器配置在提交后会立即生效，请开发者谨慎填写及选择。加解密方式的默认状态为明文模式，选择兼容模式和安全模式需提前配置好相关加解密代码，详情请参考消息体签名及解密部分的文档。
3.2后台接口调试
3.2.1设备授权硬件设备接入微信硬件平台首先要进行设备授权。查看 设备授权新接口获取到的二维码即为一机一码，设备厂商利用二维码生成器把获取到的二维码串生成为二维码，用户扫描该二维码后，关注厂商公众号，即可绑定设备注意：设备授权时必须填上product_id
3.2.2接收设备绑定/解绑事件用户扫描一机一码，关注厂商公众号，即可绑定设备，此时厂商会接收到微信硬件平台推送的绑定事件。绑定关系即deviceid（设备id）与openid（用户id）的关系。若用户解绑设备，厂商会收到解绑事件。具体接口: http://iot.weixin.qq.com/wiki/document-2_2.html
3.2.3其他API查看 平台基础消息接口
-
4.OpenAPI调试
微信硬件平台和设备云端URL消息交互，分成三种消息类型：
-
微信硬件平台查询设备消息
当微信硬件平台侧需要查询设备信息的时候，微信硬件平台将会POST查询消息发送到设备云端URL上，设备云端收到请求后，立即返回成功收到请求。待设备云端异步查询成功后，将查询结果POST给微信硬件平台。
-
微信硬件平台设置设备消息
当微信硬件平台侧需要设置设备信息的时候，微信硬件平台将会POST设置消息发送到设备云端URL上，接入者收到请求后，立即返回成功收到请求。待设备云端异步设置设备成功后，将设置结果POST给微信硬件平台。
-
设备云端通知微信硬件平台消息
当设备状态有变化或者有消息需要通知微信硬件平台侧时候，设备云端POST消息给微信硬件平台。微信硬件平台立即返回成功收到请求。待微信硬件平台将消息处理成功后，将处理消息成功的行为POST给设备云端URL上。查看 设备端open API文档
-
微信硬件云标准接入流程 —— 设备商云连接微信硬件云通道
-
1.申请认证公众号&开通设备功能
1.1公众号申请
1.2登录公众平台，点击左边功能栏的"添加功能插件"，选择"设备功能"。
点击"开通"，阅读并同意《微信公众平台微信互联设备功能服务协议》。
-
2.添加产品
进行产品开发前，第三方需要在"公众平台-设备功能"内添加接入的产品。一个公众号允许添加多种产品（比如可以添加N款音箱和N款车机），每种添加成功的产品都默认获得微信硬件平台分配的100个设备授权配额。
2.1进入"设备功能"，点击"添加产品"
2.2产品基础资料登记
其中，接入方案中勾选“微信硬件云标准接入方案”——厂商云连接微信硬件云通道。“厂商云连接微信硬件云通道”即：
2.3产品能力登记
-
3.产品开发调试
3.1服务器配置
为了接收到微信发送的设备消息（如绑定事件、耗电提醒等），设备厂商需要在mp平台上配置接收微信硬件消息的URL。配置启用后，微信转发的消息将会按照OpenAPI的接口定义以Json格式推送到开发者配置URL。
3.1.1登录公众平台，点击“设备功能”，进入“设置”页面
3.1.2点击“修改配置”按钮，进入服务器配置填写页面。填写服务器地址（URL）、Token和EncodingAESKey。其中URL是开发者用来接收微信互联设备消息和事件的接口URL。Token可由开发者任意填写，用作生成签名（该Token会和接口URL中包含的Token进行对比，从而验证安全性）。EncodingAESKey由开发者填写或随机生成，将用作消息体加解密密钥。
3.1.3选择消息加密方式：明文模式、兼容模式和安全模式。模式的选择与服务器配置在提交后会立即生效，请开发者谨慎填写及选择。加解密方式的默认状态为明文模式，选择兼容模式和安全模式需提前配置好相关加解密代码，详情请参考消息体签名及解密部分的文档。
3.2后台接口调试
3.2.1设备授权
硬件设备接入微信硬件平台首先要进行设备授权。查看 设备授权新接口获取到的二维码即为一机一码，设备厂商利用二维码生成器把获取到的二维码串生成为二维码，用户扫描该二维码后，关注厂商公众号，即可绑定设备注意：设备授权时必须填上product_id
3.2.2接收设备绑定/解绑事件
用户扫描一机一码，关注厂商公众号，即可绑定设备，此时厂商会接收到微信硬件平台推送的绑定事件。绑定关系即deviceid（设备id）与openid（用户id）的关系。若用户解绑设备，厂商会收到解绑事件。具体接口: http://iot.weixin.qq.com/wiki/document-2_2.html
3.2.3其他API查看 平台基础消息接口
-
4.OpenAPI调试
微信硬件平台和设备云端URL消息交互，分成三种消息类型：
-
微信硬件平台查询设备消息
当微信硬件平台侧需要查询设备信息的时候，微信硬件平台将会POST查询消息发送到设备云端URL上，设备云端收到请求后，立即返回成功收到请求。待设备云端异步查询成功后，将查询结果POST给微信硬件平台。
-
微信硬件平台设置设备消息
当微信硬件平台侧需要设置设备信息的时候，微信硬件平台将会POST设置消息发送到设备云端URL上，接入者收到请求后，立即返回成功收到请求。待设备云端异步设置设备成功后，将设置结果POST给微信硬件平台。
-
设备云端通知微信硬件平台消息
当设备状态有变化或者有消息需要通知微信硬件平台侧时候，设备云端POST消息给微信硬件平台。微信硬件平台立即返回成功收到请求。待微信硬件平台将消息处理成功后，将处理消息成功的行为POST给设备云端URL上。查看 设备端openAPI文档
-
技术介绍
包括Airkiss，AriSync，蓝牙精简协议，直连SDK等
