button组件小程序跳转订阅消息设置页
收藏基础库 3.27.0 开始支持本能力。支持小程序跳转订阅消息设置页，需要将 button 组件 open-type 的值设置为 openSubscribeMessageSetting。
使用该功能前，建议先前置调用 tt.getSettings 获取用户订阅消息开启状态，否则当用户点击该功能时 bindopenSubscribeMessageSetting 会返回异常。订阅消息接入指南请参考：订阅消息 2.0。
属性说明
属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
open-type | string | | 是 | 用于调用开放能力，此场景下需要设置为 "openSubscribeMessageSetting" | 3.27.0 |
bindopenSubscribeMessageSetting | EventHandle | | 否 | 监听跳转订阅消息设置页的回调，open-type=openSubscribeMessageSetting 时有效 | 3.27.0 |
bindopenSubscribeMessageSetting 事件对象的 detail
object 类型，属性如下：
属性名 | 类型 | 说明 | 最低支持版本 |
errMsg | string | 错误描述 | 3.27.0 |
errNo | number | 错误码 | 3.27.0 |
回调成功
Object 类型，属性如下：
参数 | 参数类型 | 说明 |
errMsg | string | 跳转成功信息，恒为 'openSubscribeMessageSetting:ok' |
errNo | string | 恒为 0 |
回调失败
Object 类型，属性如下：
参数 | 参数类型 | 说明 |
errMsg | string | 跳转失败信息，以 'openSubscribeMessageSetting:fail'开头 |
errNo | number | 错误码，详见错误说明 |
错误说明
errNo | errMsg | 说明 | 最低支持版本 |
21501 | First check whether the user authorizes the subscription message using tt.getSetting | 请使用 openSubscribeMessageSetting 前前置判断当前用户是否已开启订阅消息通知权限。 | 3.27.0 |
21501 | check that the message template has additional alerts enabled or that the number of calls has reached the upper limit | 请检查小程序已配置的订阅消息模版是否已开启提醒设置或该用户使用 openSubscribeMessageSetting 能力已达当天上限。 | 3.27.0 |
扫码体验
代码示例
// ttml <button open-type="openSubscribeMessageSetting" bindopenSubscribeMessageSetting="eventHandler"> 点击跳转订阅设置页 </button>
// ttss Page({ data: { result: '', }, onShow() { console.log('onShow'); }, eventHandler(e) { console.log(e); if (!e.detail.errNo) { tt.showToast({ title: 'success', }); } else { tt.showToast({ title: 'failed', icon: 'none', }); } this.setData({ result: e.detail.errMsg, }); }, });
Bug & Tip
无。
