微信硬件平臺

概述

微信硬件平臺介紹

微信硬件平臺是微信在連接人、連接企業和服務之后，推出的連接硬件設備的物聯網解決方案。微信硬件平臺以微信用戶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文檔