button组件小程序跳转订阅消息设置页

我的收藏

基础库 3.27.0 开始支持本能力。支持小程序跳转订阅消息设置页，需要将 button 组件 open-type 的值设置为 openSubscribeMessageSetting。
button 组件常规属性请参考 button 按钮。

使用该功能前，建议先前置调用 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

无。