微信小店
微信门店
微信智能接口
微信设备功能

摇一摇事件通知

出自微信公众平台开发者文档
跳转到: 导航, 搜索

摇一摇事件通知

接口说明

用户进入摇一摇界面,在“周边”页卡下摇一摇时,微信会把这个事件推送到开发者填写的URL(登录公众平台进入开发者中心设置)。推送内容包含摇一摇时“周边”页卡所摇到设备的信息,以及附近最多五个属于该公众账号的设备信息。当摇出列表时,只推送所摇到设备的信息,但不推送附近设备的信息。

微信服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次。关于重试的消息排重,推荐使用FromUserName + CreateTime 排重。假如服务器无法保证在五秒内处理并回复,可以直接回复空串,微信服务器不会对此作任何处理,并且不会发起重试。

推送XML数据包示例

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1433332012</CreateTime>
    <MsgType><![CDATA[event]]></MsgType>
    <Event><![CDATA[ShakearoundUserShake]]></Event>
    <ChosenPageId>234</ChosenPageId>
    <ChosenBeacon>
        <Uuid><![CDATA[uuid]]></Uuid>
        <Major>major</Major>
        <Minor>minor</Minor>
        <Distance>0.057</Distance>
        <Rssi>15.013</Rssi>
        <Measurepower>15.013</Measurepower>
    </ChosenBeacon>
    <AroundBeacons>
        <AroundBeacon>
            <Uuid><![CDATA[uuid]]></Uuid>
            <Major>major</Major>
            <Minor>minor</Minor>
            <Distance>166.816</Distance>
            <Rssi>15.013</Rssi>
            <Measurepower>15.013</Measurepower>
        </AroundBeacon>
        <AroundBeacon>
            <Uuid><![CDATA[uuid]]></Uuid>
            <Major>major</Major>
            <Minor>minor</Minor>
            <Distance>15.013</Distance>
            <Rssi>15.013</Rssi>
            <Measurepower>15.013</Measurepower>
        </AroundBeacon>
    </AroundBeacons>
</xml>

参数说明

参数 说明
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及以上版本才会返回。