# 关系链互动提醒
# 功能介绍
当开发者使用 好友互动 或 排行榜 能力时,可使用 关系链互动提醒功能。 好友互动提醒 、排行榜好友超越提醒,每个模版分别只需要订阅 1 次。
- 好友互动提醒
- 排行好友超越提醒
# 一次性订阅消息 和 关系链互动提醒 区别
能力 | 普通一次性订阅消息 | 基于关系链的系统订阅消息 |
---|---|---|
游戏场景 | 开发者游戏内自定义 | 仅限好友互动、排行榜超越场景 |
订阅场景 | 开发者控制订阅时机 | 开发者控制订阅时机 |
订阅限制 | 可同时订阅3个消息模版 | 可同时订阅3个消息模版 |
订阅成功回调 | 支持 | 支持 |
下发限制 | 订阅一次,发一条 | 订阅一次,发多条(永久有效) |
下发消息逻辑 | 开发者自定时机,后台下发 | 平台下发消息 |
下发消息内容 | 开发者自定义,MP申请模版 | 平台设置内容 |
# 如何设计消息触发场景
# 1、好友互动
开发者在游戏内设置与微信好友赠送礼物、偷取道具等互动行为。当有用户成功触发互动行为时,若对方已订阅“好友互动提醒”,则对方会 收到对应的服务通知。每次成功互动,下发一条消息。
每次调用 wx.modifyFriendInteractiveStorage 且用户确认互动后,会产生一条服务通知。接口参数quiet
设置为true
的接口调用,将不会触发服务通知。
# 2、排行榜超越
① 开发者在游戏内为用户提供好友排行榜服务
② 开发者需在「MP后台-游戏能力地图-微信排行榜配置」配置 排行榜
③ 当用户本周期内有战绩且已订阅“排行榜超越提醒”,则当好友战绩超越该用户时,该用户将收到对应的服务通知。当天第一次被超越,下发一条消息。
注意:开发者需先提交版本审核及运营素材,才可查看排行榜设置入口。
# 3. API
- 小游戏系统订阅消息接口 wx.requestSubscribeSystemMessage
示例代码:
wx.requestSubscribeSystemMessage({
msgTypeList: ['SYS_MSG_TYPE_INTERACTIVE', 'SYS_MSG_TYPE_RANK'],
success(res) {
console.log(res)
// {
// errMsg: "requestSubscribeSystemMessage:ok",
// SYS_MSG_TYPE_INTERACTIVE: 'accept'
// SYS_MSG_TYPE_RANK: 'reject'
// }
},
fail(res) {
console.log(res)
},
complete(res) {
console.log(res)
} })
用户完成订阅后,系统订阅消息会被添加到用户的小程序设置页,通过 wx.getSetting 接口可获取用户对系统订阅消息的订阅状态。
# 4.最佳实践
我们提供了订阅相关的代码片段,可以预览代码片段体验如何订阅和赠送好友金币