小程序云开发-借助云开发实现小程序消息订阅功能丨实战

博客小程序中有文章留言评论和评论回复功能，但是当有用户评论了文章或者回复了评论时，管理员及用户并不知道，不能及时作出回复。所以消息订阅功能上线了，用户只需订阅消息，就可以在合适的时机收到消息通知。 博客小程序一共有两个消息订阅，分别是文章评论回复通知和留言评论提醒。

1.页面设计

消息订阅页面设计的比较简单，就是一个list列表，每行的左边显示消息名称，右边显示一个checkbox。

2.登录微信公众平台，选择消息订阅类型获取模板ID

3.消息订阅权限配置

新建消息订阅云函数文件夹，并在config.json 中配置 subscribeMessage.send API 的权限。

4.调起消息订阅界面

使用wx.requestSubscribeMessage API调起消息订阅界面

    wx.requestSubscribeMessage({
      // 传入订阅消息的模板id，模板 id 可在小程序管理后台申请
      tmplIds: [lessonTmplId],
      success(res) {
        console.log(res)
        // 申请订阅成功
        if (res["ei8TI54LSrC0kMMl5yQ3A-h61bjGB4iZIH56A2-dIns"] == "accept") {
         // 数据库保存或者更新用户订阅信息
        } else {
          wx.showToast({
            title: '订阅失败',
            icon: 'none',
            duration: 2000,
          });
         // 数据库删除用户订阅信息
        }
      },
      fail(err) {
        console.log("err=" + err)
      }
    });

调起客户端小程序订阅消息界面，返回用户订阅消息的操作结果。

6.云函数发送订阅消息

当用户点击提交评论按钮时，触发发送订阅消息事件，调用 subscribeMessage.send API。

小程序端前台触发代码如下

isChinese(temp) {
  var re = /[^u4e00-u9fa5]/;
  if (re.test(temp)) return false;
  return true;
},
sendAddCommentMessage(nickName, inputData, article_id, create_date) {
    var flag = this.isChinese(nickName);
    var nick = '';
    if (flag){
      nick = nickName
    }else{
      nick = '虚拟名字'
    }
    var data = {
      name3: {
        value: nick // 这里本来是取留言者的nickName,但是如果nickName中包含特殊字符的话就会报错（例如：★那一抹笑^穿透阳光★），所以无奈之下只能取一个虚拟名字
      },
      thing1: {
        value: inputData
      },
      date2: {
        value: create_date
      }
    }
	// 调用消息订阅云函数
    wx.cloud.callFunction({
      name: 'openapi',
      data: {
        action: 'sendAddCommentMessage',
		// 跳转到指定的文章
        page: "pages/articleDetail/articleDetail?article_id=" + article_id,
        data: data,
        templateId: lessonTmplId,
      },
      success: function(res) {
        console.log("留言消息订阅发送成功----")
      },
      fail: err => {
        console.log("留言消息订阅发送失败----")
      },
      complete: res => {}
    })
  },

这里有个小坑，留言评论提醒订阅消息有个字段取的是评论者的昵称，使用的是订阅消息参数值name字段，但是微信用户的昵称含有特殊字符，例如：‘★那一抹笑^穿透阳光★’，订阅消息参数值内容限制说明明确指出name字段不能含有特殊字符，所以当用户的昵称带有特殊字符的时候云函数就会报错，所以此时需要判断一下用户的昵称是否还有特殊字符，如果有，就特殊处理一下，保证其消息能正常发送。

云函数调用 subscribeMessage.send API代码如下

async function sendAddCommentMessage(event) {
  try {
    // 发送订阅消息
    let result = await cloud.openapi.subscribeMessage.send({
      touser: '',//管理员的openid
      page: event.page,
      lang: 'zh_CN',
      data: event.data,
      templateId: 'ei8TI54LSrC0kMMl5yQ3A-h61bjGB4iZIH56A2-dIns',
    });
    return result;
  } catch (e) {
    console.log('消息订阅之新增评论：'+e)
    return e;
  }
}

7.管理员在微信接收消息提醒

• 当有用户评论时，微信服务通知就会收到消息。

• 点开微信服务通知查看

• 点击留言评论提醒服务通知，可以跳转到具体的文章详情页面。

8.云开发消息订阅总结

1. 由于长期性订阅消息，目前仅向政务民生、医疗、交通、金融、教育等线下公共服务开放，所以像留言评论提醒和文章评论回复通知都是属于一次性订阅类型，订阅一次就只会收到一次消息提醒。

2.当用户勾选了订阅面板中的“总是保持以上选择，不再询问”时，用户再次点击订阅时，不会出现订阅消息界面，但是会默认累加一次订阅次数。

3.填写消息订阅内容时一定要注意订阅消息参数值内容限制说明，不然云函数会报错。