搖一搖接口說明
用戶進入搖一搖界面,在“周邊”頁卡下搖一搖時,微信會把這個事件推送到開發者填寫的URL(登錄公眾平臺進入開發者中心設置)。推送內容包含搖一搖時“周邊”頁卡所搖到設備的信息,以及附近最多五個屬于該公眾賬號的設備信息。當搖出列表時,只推送所搖到設備的信息,但不推送附近設備的信息。
微信服務器在五秒內收不到響應會斷掉連接,并且重新發起請求,總共重試三次。關于重試的消息排重,推薦使用FromUserName + CreateTime 排重。假如服務器無法保證在五秒內處理并回復,可以直接回復空串,微信服務器不會對此作任何處理,并且不會發起重試。
參數 | 說明 |
---|---|
ToUserName | 開發者微信號 |
FromUserName | 搖一搖用戶(一個OpenID) |
CreateTime | 消息創建時間 (整型) |
MsgType | 消息類型,event |
Event | 事件類型,ShakearoundUserShake |
ChosenPageId | “周邊”頁卡展示出來的頁面ID |
UUID、major、minor | UUID、major、minor |
Distance | 設備與用戶的距離(浮點數;單位:米);當距離較遠時,iOS會直接返回-1 |
Rssi | 接收信號的強度指示,單位是dBm;當距離較遠時,iOS會直接返回0 |
Measurepower | 信號參考值 |
其中,ChosenpageId、Rssi在微信6.3.8及以上版本才會返回;Measurepower僅在Android微信6.3.8及以上版本才會返回。
?