微信運動接入說明文檔

智能硬件現在是熱火朝天，BLE是智能硬件非常重要的一塊，像手環，手表，電子秤，從中興出來后參加的一個創業公司做的也是智能硬件相關，從那時候開始組建了自己的技術交流群，從開始的7個人到現在的三百多人，中途不斷有人加入，也不斷有人被踢出去，有一個銷售非常任性，每次進來都不修改名字，被我踢出去了又加進來，后面進來的時候名字改成了“踢掉-籃球”，剛好我的群昵稱就是“深圳-籃球”，從開始到現在也認識了非常有趣有愛的伙伴，這篇文章就是一個伙伴貢獻出來的。希望大家在工作學習的時候有自己的小伙伴，這樣工作學習才會有更多的樂趣。

1、微信公眾號

1.1 申請測試公眾號

首先需要先到http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login 申請一個用于測試的公眾號。

申請的步驟：打開上面的網址，點擊登陸后，出現二維碼，用微信掃一下，在彈出的頁面點確認登陸，然后網頁會自動進入測試號界面，如下圖：

需要注意的是，上圖中的appID 和appsecret 這兩個值在獲取access_token 會用到。

1.2 添加藍牙產品

在測試號的界面，找到“功能服務”->設備功能->開啟->設置->確定，如下圖：

點擊確定之后，進行下一步。

點擊“添加產品”。然后如下圖配置選項（紅圈地方需要注意，其他隨便填）：

點擊“添加”，離開此頁。

這樣就成功添加了一個產品，如下圖所示：

每個產品可以授權100 個。添加完后，并不表示進入公眾號后就可以去連藍牙了，這只是將公眾號配置成具有藍牙功能，想要連接藍牙設備，還得繼續往下。另外，注意上圖標紅圈的那個值24033它是產品ID（product_id），在授權時會用到。

1.3 添加藍牙設備

上面的步驟只是添加了一類產品，我們還需要添加我們具體的藍牙設備。

A.首先打開http://mp.weixin.qq.com/debug，接口類型和接口列表按下圖填寫：

上圖中的appid 與secret 需要填入的值就是圖1 中提到的appID 和appsecret 值，填入完畢之后，點擊檢查問題，如上圖所示就是正確的。

B.然后我們需要獲取到deviceid 這個值，按照下圖填入：

我們需要在access_token 里面填寫ACCESS_TOKEN&product_id=PRODUCT_ID,ACCESS_TOKEN 在圖7 里面可以看到，然后PRODUCT_ID 就在圖6 中的24033。

如果只是單純的填入access_token，會產生錯誤提示：

{

"base_resp":{

"errcode":100020,

"errmsg":"accountquotanotenough"

}

}

原因是deviceid 的產生需要指定產品ID，表明它是基于哪個產品。解決方法是：在access_tokey 里填寫ACCESS_TOKEN&product_id=PRODUCT_ID,如下：

填寫完畢后，點擊“檢查問題”，返回如下圖所示：

會產生一個deviceid 和一個二維碼地址。這個二維碼地址是對應該設備的，它與公眾號二維碼的不同是，它加入了設備信息，用戶在掃描二維碼后，可以綁定設備，而掃描公眾號二維碼，則不會要求綁定設備。二維碼地址可以通過這個網站http://cli.im/url 來產生二維碼圖片。

C.最后一步就是配置藍牙設備的屬性。首先將接口類型選擇為“硬件接入API 接口調試”，接口列表選擇為“設備授權-利用deviceid 更新設備屬device/authorize_device”：

Body 中填入：

{
"device_num": "1",
"device_list": [
{
"id": "gh_27c7dfdbf95f_d861293015853e8e",
"mac": "E98252236C83",
"connect_protocol": "3",
"auth_key": "1234567890ABCDEF1234567890ABCDEF",
"close_strategy": "1",
"conn_strategy": "1",
"crypt_method": "1",
"auth_ver": "1",
"manu_mac_pos": "-1",
"ser_mac_pos": "-2",
"ble_simple_protocol": "1"
}
],
"op_type": "1",
"product_id": "24033"
}

我們來解讀一下BODY 的信息，BODY 是一個json 結構，即“變量”：“值”的格式構成，不清楚的可以查一下。

{

"device_num":"1",//表示device_list 里有多少項，1 表示1 項，如果是2，list 就得有兩項。

"device_list":[//設備列表

{

"id":"gh_27c7dfdbf95f_541afd8d1130e487",//這個值要與BLE 固件里的DEVICE_ID 一致，可以自定義，也可通過微信HTTP 接口生成。

"mac":"E98252236C83",//這個值是硬件篇提到的BLE 設備的MAC 地址，與廣播數據里的MAC 地址順序一樣，也和手機掃描到的MAC 地址順序一樣。

"connect_protocol":"3",//3 表示BLE 藍牙協議

"auth_key":"000102030405060708090a0b0c0d0e0f",//和BLE 固件里的aes_key 值一致。

"close_strategy":"1",//1：退出公眾號頁面時即斷開連接

"conn_strategy":"1",//1：（第1bit 置位）在公眾號對話頁面，不停的嘗

試連接設備

"crypt_method":"1",//1：AES 加密

"auth_ver":"1",//加密版本，0 是不加密

"manu_mac_pos":"-1",//-1：MAC 地址在尾部

"ser_mac_pos":"-2"//-2：表示serialnumber 不包含mac 地址

}

],

"op_type":"0",//0 表示新增新設備，1 表示更改已經寫入的設備的屬性，第一次用0，之后用1。

"product_id":"24033"//對用添加的產品號，op_type=0 時需要。

特別需要注意這些參數的配置，具體的介紹可以在這個網址查詢

http://iot.weixin.qq.com/wiki/new/index.html?page=3-4-5

最后點擊檢查問題，如果正確就返回下面的值：

2.藍牙設備二維碼的生成

首先打開網址http://cli.im/url，然后填入圖10 中生成的二維碼地址，如下圖

3.綁定藍牙設備

使用微信掃描二維碼，然后點擊“綁定設備”，點擊“進入公眾號”

進入公眾號之后，公眾號就會自動連接藍牙設備，如果連接成功就會顯示“已連接1 個設備”

這樣我們就可以將手環的運動步數上傳到微信運動公眾號的排行榜了。（需要先關注微信運動公眾號）進入微信運動公眾號，然后點擊排行榜，手環數據就可以上傳到微信運動。