# 长期订阅状态通知
本文档描述服务器端接收的消息或事件,详细说明参见消息推送。
事件英文名:wxalive_follow_notify
用户订阅小程序直播后会触发事件通知
# 1. 消息参数
# 请求体 Request Payload
| 参数名 | 类型 | 说明 | 枚举 |
|---|---|---|---|
| ToUserName | string | 小程序的原始ID | - |
| FromUserName | string | 发送者的openid | - |
| CreateTime | number | 消息创建时间(整型) | - |
| MsgType | string | 固定 event | - |
| Event | string | 固定 wxalive_follow_notify | - |
| room_id | number | 房间号 | - |
| user_openid | string | 订阅者的openid | - |
| time | number | 订阅的时间戳 | - |
| live_status | number | 阅或者取消订阅时直播间状态,取值: | 枚举值 |
| action | string | 订阅行为 | 枚举值 |
# 2. 消息返回
# 返回体 Response Payload
回复 success 或空字符串(无需加密)
# 3. 枚举信息
# Body.live_status Enum
阅或者取消订阅时直播间状态,取值:
| 枚举值 | 描述 |
|---|---|
| 101 | 直播中 |
| 102 | 未开始 |
| 103 | 已结束 |
# Body.action Enum
订阅行为
| 枚举值 | 描述 |
|---|---|
| add_follow | 订阅 |
| del_follow | 取消订阅 |
# 4. 注意事项
本事件无特殊注意事项
# 5. 代码示例
请求示例
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1546924844</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[wxalive_follow_notify]]></Event>
<FollowNotify>
<room_id>1</room_id>
<user_openid>![CDATA[xxx]]</user_openid>
<time>1546924844</time>
<live_status>101</live_status>
<action>![CDATA[add_follow]]</action>
</FollowNotify>
</xml>
返回示例
SUCCESS