摇一摇接口说明
用户进入摇一摇界面,在“周边”页卡下摇一摇时,微信会把这个事件推送到开发者填写的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及以上版本才会返回。