微信硬件平臺

概述

微信硬件平臺介紹

微信硬件平臺是微信在連接人、連接企業(yè)和服務之后，推出的連接硬件設備的物聯(lián)網(wǎng)解決方案。微信硬件平臺以微信用戶ID體系為基礎，以用戶價值為依歸，立志于打造用戶和設備廠家共贏的物聯(lián)平臺，實現(xiàn)人，設備、廠家的互聯(lián)互通。

通過微信硬件平臺提供的AirSync、AirKiss、硬件JSAPI、直連SDK等技術，藍牙設備、Wi-Fi設備與移動網(wǎng)絡設備等智能設備都能便捷地實現(xiàn)與微信之間的互聯(lián)和通訊，用戶可以通過公眾號查看和控制自己的手環(huán)、電視、空調和其它智能家電等。

智能設備能夠通過各種方式與微信綁定，如：掃描設備二維碼、調用JSAPI與用戶建立對應關系等。硬件設備廠商可以因此準確地了解到設備用戶的相關信息。

此外，微信硬件平臺向智能設備提供了多種增值服務，包括社交元素、模式識別技術等，設備廠家可為用戶提供更多的服務，以提升用戶黏性。

微信硬件平臺的優(yōu)勢

微信硬件平臺為設備提供直連數(shù)據(jù)通道，設備可以通過直連SDK直接接入微信硬件服務器，將大大減輕設備廠家接入難度與研發(fā)投入負擔、縮短產(chǎn)品上市周期。
微信擁有完善的ID體系。接入微信硬件平臺即意味著第三方設備能夠使用微信的各類ID體系。
微信為第三方提供了輕應用形式的開發(fā)方案。結合標準微信JSAPI和微信硬件平臺特有的API，硬件廠商可以快速構建自己的輕應用。
微信擁有數(shù)量龐大的活躍用戶。有利于硬件設備口碑傳播的同時，App推廣的成本也將大幅降低。
微信硬件平臺為第三方提供了O2O的便捷。設備廠商可以在公眾號上建立微信小店，根據(jù)設備運行情況，定期提供配件和耗材的購買服務，為用戶提供更好的服務體驗。

接入方案介紹

設備接入方案即設備接入微信硬件平臺使用的數(shù)據(jù)傳輸方案，目前包含平臺基礎接入方案與微信硬件云標準接入方案。

1.平臺基礎接入方案
適用對象：
（1）擁有后臺服務器的設備廠商
（2）希望在公眾號體系內獨立實現(xiàn)設備相關功能（即不需要微信硬件平臺提供的產(chǎn)品標準能力）
（3）希望設備可以收發(fā)微信消息（圖片／音樂／文件／地理位置等）

微信硬件平臺是基于微信公眾平臺基礎構建的，微信公眾平臺基礎技術架構如圖1所示。

圖1 微信公眾平臺技術架構

公眾號運營分為編輯模式和開發(fā)模式。

在編輯模式下，公眾號運營者登錄微信公眾號管理頁面，通過手動方式編輯消息和管理用戶。
在開發(fā)模式下，運營者可以獲得更多高級的接口功能（包括設備功能），通過編寫消息接口程序，讓第三方服務器自動管理用戶和消息。

圖2 微信硬件平臺基礎接入方案技術架構

在這個基礎架構里，設備廠家必須有自己的服務器，通過硬件平臺基礎消息接口，接收設備和用戶消息，提供設備服務。
2.微信硬件云標準接入方案
適用對象：希望通過微信硬件平臺提供的產(chǎn)品標準能力集定義設備數(shù)據(jù)，實現(xiàn)設備數(shù)據(jù)互聯(lián)互通的設備。

（1）設備直連微信硬件云通道
微信硬件平臺為設備提供直連數(shù)據(jù)通道，設備可以通過直連SDK直接接入微信硬件服務器，打通設備到云端的通道。框架如圖3所示：

圖3 設備直連微信硬件云通道

在直連方案中，微信硬件平臺將提供設備信息管理、綁定關系存儲、設備權限管理、設備固件版本控制、設備數(shù)據(jù)統(tǒng)計、數(shù)據(jù)登錄鑒權、狀態(tài)更新、固件更新等服務。

具體描述：請參照文檔新增直連數(shù)據(jù)通道

（2）設備商云連接微信硬件云通道
設備連接廠商服務器后，可通過設備openAPI與微信硬件云對接?？蚣苋鐖D4所示：

圖4 設備商云連接微信硬件云通道

目前，設備廠商可通過微信硬件平臺提供的開發(fā)模式接入設備。整體技術架構如圖5所示：

圖5 微信硬件平臺開發(fā)模式技術架構

接入流程

認證服務號
開通設備功能
開發(fā)
審核并發(fā)售

平臺基礎接入流程

1.申請認證公眾號&開通設備功能

1.1 公眾號申請

1.2登錄公眾平臺，點擊左邊功能欄的"添加功能插件"，選擇"設備功能"。

點擊"開通"，閱讀并同意《微信公眾平臺微信互聯(lián)設備功能服務協(xié)議》。
2.添加產(chǎn)品

進行產(chǎn)品開發(fā)前，第三方需要在"公眾平臺-設備功能"內添加接入的產(chǎn)品。一個公眾號允許添加多種產(chǎn)品（比如可以添加N款音箱和N款車機），每種添加成功的產(chǎn)品都默認獲得微信硬件平臺分配的100個設備授權配額。

2.1進入"設備功能"，點擊"添加產(chǎn)品"

2.2產(chǎn)品基礎資料登記

其中，接入方案中勾選“平臺基礎接入方案”?！捌脚_基礎接入方案”即：

2.3產(chǎn)品能力登記
3.產(chǎn)品開發(fā)調試

3.1服務器配置

廠商可以選擇配置新的服務器，用于接收硬件產(chǎn)生的消息和事件，如“耗電提醒”等。

該服務器配置對于“平臺基礎接入方案”并非必需，若廠商配置了服務器，則所有有關硬件的消息（如綁定事件、耗電提醒等）會發(fā)送到該服務器URL中，而其余公眾號有關消息（如關注事件、客服消息等）依然發(fā)送到公眾號配置的服務器URL中。

若廠商未配置服務器，則所有消息（包括硬件消息和公眾號消息）都會發(fā)送到原有公眾號配置的服務器URL中。

具體配置方式如下：

3.1.1登錄公眾平臺，點擊“設備功能”，進入“設置”頁面

3.1.2點擊“修改配置”按鈕，進入服務器配置填寫頁面。填寫服務器地址（URL）、Token和EncodingAESKey。其中URL是開發(fā)者用來接收微信互聯(lián)設備消息和事件的接口URL。Token可由開發(fā)者任意填寫，用作生成簽名（該Token會和接口URL中包含的Token進行對比，從而驗證安全性）。EncodingAESKey由開發(fā)者填寫或隨機生成，將用作消息體加解密密鑰。

3.1.3選擇消息加密方式：明文模式、兼容模式和安全模式。模式的選擇與服務器配置在提交后會立即生效，請開發(fā)者謹慎填寫及選擇。加解密方式的默認狀態(tài)為明文模式，選擇兼容模式和安全模式需提前配置好相關加解密代碼，詳情請參考消息體簽名及解密部分的文檔。

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登錄公眾平臺，點擊左邊功能欄的"添加功能插件"，選擇"設備功能"。

點擊"開通"，閱讀并同意《微信公眾平臺微信互聯(lián)設備功能服務協(xié)議》。
2.添加產(chǎn)品

進行產(chǎn)品開發(fā)前，第三方需要在"公眾平臺-設備功能"內添加接入的產(chǎn)品。一個公眾號允許添加多種產(chǎn)品（比如可以添加N款音箱和N款車機），每種添加成功的產(chǎn)品都默認獲得微信硬件平臺分配的100個設備授權配額。

2.1進入"設備功能"，點擊"添加產(chǎn)品"

2.2產(chǎn)品基礎資料登記

其中，接入方案中勾選“微信硬件云標準接入方案”——“設備直連微信硬件云通道”?！霸O備直連微信硬件云通道”即：

SDK開發(fā)部分后續(xù)具體介紹。

2.3產(chǎn)品能力登記
3.產(chǎn)品開發(fā)調試

3.1服務器配置

為了接收到微信發(fā)送的設備消息（如綁定事件、耗電提醒等），設備廠商需要在mp平臺上配置接收微信硬件消息的URL。配置啟用后，微信轉發(fā)的消息將會按照OpenAPI的接口定義以Json格式推送到開發(fā)者配置URL。

3.1.1登錄公眾平臺，點擊“設備功能”，進入“設置”頁面

3.1.2點擊“修改配置”按鈕，進入服務器配置填寫頁面。填寫服務器地址（URL）、Token和EncodingAESKey。其中URL是開發(fā)者用來接收微信互聯(lián)設備消息和事件的接口URL。Token可由開發(fā)者任意填寫，用作生成簽名（該Token會和接口URL中包含的Token進行對比，從而驗證安全性）。EncodingAESKey由開發(fā)者填寫或隨機生成，將用作消息體加解密密鑰。

3.1.3選擇消息加密方式：明文模式、兼容模式和安全模式。模式的選擇與服務器配置在提交后會立即生效，請開發(fā)者謹慎填寫及選擇。加解密方式的默認狀態(tài)為明文模式，選擇兼容模式和安全模式需提前配置好相關加解密代碼，詳情請參考消息體簽名及解密部分的文檔。

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查詢消息發(fā)送到設備云端URL上，設備云端收到請求后，立即返回成功收到請求。待設備云端異步查詢成功后，將查詢結果POST給微信硬件平臺。
- 微信硬件平臺設置設備消息
  
  當微信硬件平臺側需要設置設備信息的時候，微信硬件平臺將會POST設置消息發(fā)送到設備云端URL上，接入者收到請求后，立即返回成功收到請求。待設備云端異步設置設備成功后，將設置結果POST給微信硬件平臺。
- 設備云端通知微信硬件平臺消息
  
  當設備狀態(tài)有變化或者有消息需要通知微信硬件平臺側時候，設備云端POST消息給微信硬件平臺。微信硬件平臺立即返回成功收到請求。待微信硬件平臺將消息處理成功后，將處理消息成功的行為POST給設備云端URL上。查看設備端open API文檔

微信硬件云標準接入流程 —— 設備商云連接微信硬件云通道

1.申請認證公眾號&開通設備功能

1.1公眾號申請

1.2登錄公眾平臺，點擊左邊功能欄的"添加功能插件"，選擇"設備功能"。

點擊"開通"，閱讀并同意《微信公眾平臺微信互聯(lián)設備功能服務協(xié)議》。
2.添加產(chǎn)品

進行產(chǎn)品開發(fā)前，第三方需要在"公眾平臺-設備功能"內添加接入的產(chǎn)品。一個公眾號允許添加多種產(chǎn)品（比如可以添加N款音箱和N款車機），每種添加成功的產(chǎn)品都默認獲得微信硬件平臺分配的100個設備授權配額。

2.1進入"設備功能"，點擊"添加產(chǎn)品"

2.2產(chǎn)品基礎資料登記

其中，接入方案中勾選“微信硬件云標準接入方案”——廠商云連接微信硬件云通道。“廠商云連接微信硬件云通道”即：

2.3產(chǎn)品能力登記
3.產(chǎn)品開發(fā)調試

3.1服務器配置

為了接收到微信發(fā)送的設備消息（如綁定事件、耗電提醒等），設備廠商需要在mp平臺上配置接收微信硬件消息的URL。配置啟用后，微信轉發(fā)的消息將會按照OpenAPI的接口定義以Json格式推送到開發(fā)者配置URL。

3.1.1登錄公眾平臺，點擊“設備功能”，進入“設置”頁面

3.1.2點擊“修改配置”按鈕，進入服務器配置填寫頁面。填寫服務器地址（URL）、Token和EncodingAESKey。其中URL是開發(fā)者用來接收微信互聯(lián)設備消息和事件的接口URL。Token可由開發(fā)者任意填寫，用作生成簽名（該Token會和接口URL中包含的Token進行對比，從而驗證安全性）。EncodingAESKey由開發(fā)者填寫或隨機生成，將用作消息體加解密密鑰。

3.1.3選擇消息加密方式：明文模式、兼容模式和安全模式。模式的選擇與服務器配置在提交后會立即生效，請開發(fā)者謹慎填寫及選擇。加解密方式的默認狀態(tài)為明文模式，選擇兼容模式和安全模式需提前配置好相關加解密代碼，詳情請參考消息體簽名及解密部分的文檔。

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查詢消息發(fā)送到設備云端URL上，設備云端收到請求后，立即返回成功收到請求。待設備云端異步查詢成功后，將查詢結果POST給微信硬件平臺。
- 微信硬件平臺設置設備消息
  
  當微信硬件平臺側需要設置設備信息的時候，微信硬件平臺將會POST設置消息發(fā)送到設備云端URL上，接入者收到請求后，立即返回成功收到請求。待設備云端異步設置設備成功后，將設置結果POST給微信硬件平臺。
- 設備云端通知微信硬件平臺消息
  
  當設備狀態(tài)有變化或者有消息需要通知微信硬件平臺側時候，設備云端POST消息給微信硬件平臺。微信硬件平臺立即返回成功收到請求。待微信硬件平臺將消息處理成功后，將處理消息成功的行為POST給設備云端URL上。查看設備端openAPI文檔