微信小程序开发之订阅消息

微信小程序开发中我们常常可能会遇到这样的需求，用户执行某一操作后，需要在未来某一时刻给予用户反馈通知，比如在一些餐厅点餐后发送的取餐提醒，某些打卡应用的打卡提醒，等等。这些都必须在小程序外部给到用户有效的通知，所以实现此功能的方式只有一种——订阅消息。

订阅消息 主要分为两步：订阅 和 发布。

一、订阅

小程序要发送消息，首先它得知道发送给谁，然后就是该什么时候发送。因此，订阅 是必须要有的操作，就好比公众号，你若想要某个公众号能在每次发布文章时你能收到推送，就必须关注该公众号才行。

但是，和公众号不同的是，小程序只能实现 一次性消息订阅 而非永久，也就是说你订阅后消息只要发送后该订阅就失效了，以后若想要再次收到消息通知就必须再次订阅。

订阅消息代码大致如下：

wx.requestSubscribeMessage({
  tmplIds: [''],   //  需要订阅的消息模板的id的集合
  success (res) { }   //  接口调用成功的回调函数
})

那么tmplIds数组中的消息模板id在哪获取呢？

首先我们得先自己去添加配置消息模板，可以在 [微信公众平台（http://mp.weixin.qq.com）-功能-订阅消息] 中配置，配置好消息模板后即可获取其模板ID。

更多订阅消息的相关细节可以直接前往 微信官方文档·小程序（https://developers.weixin.qq.com/miniprogram/dev/api/open-api/subscribe-message/wx.requestSubscribeMessage.html） 查看。

二、发布

订阅消息之后，小程序还需要根据订阅时提供的相关信息（用户ID等）来发布消息。

上面提到的订阅操作是用户操作，体现在前端，也就是小程序端，而发布操作则体现在后端，也就是服务端，这时我们可以直接使用云开发来实现。

1. 定义云函数

我们可以定义个发布消息的云函数，代码大致如下：

const cloud = require('wx-server-sdk')  //  必须先安装wx-server-sdk
cloud.init({
  env: cloud.DYNAMIC_CURRENT_ENV    //  云环境ID
})
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.subscribeMessage.send({
        touser: 'OPENID',   // 接收者（用户）的 openid
        page: 'pages/index/index',  // 点击模板卡片后的小程序跳转页面
        lang: 'zh_CN',  //  语言类型
        data: {},  // 模板内容
        templateId: 'TEMPLATE_ID',  // 所需下发的订阅模板id
        miniprogramState: 'developer'  // 跳转小程序类型，默认是正式版
      })
    return result
  } catch (err) {
    return err
  }
}

具体参数配置可以直接前往微信官方文档·小程序（https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/subscribe-message/subscribeMessage.send.html） 查看。

有几个地方可能需要注意：

① 上述代码是云函数中的云调用，需要用到wx-server-sdk

可以通过npm install --save wx-server-sdk@latest进行安装，注意必须安装在当前云函数所在文件目录下。例如：

wx-server-sdk安装在其中

更多云调用相关内容详见→微信官方文档·小程序（https://developers.weixin.qq.com/miniprogram/dev/wxcloud/guide/openapi/openapi.html#%E4%BA%91%E8%B0%83%E7%94%A8）

② 需在 config.json 中配置 subscribeMessage.send API 的权限

{
  "permissions": {
    "openapi": [
      "templateMessage.send"
    ]
  }
}

当然，config.json文件也必须放在当前云函数所在文件目录下。

③ 有关subscribeMessage.send API参数data的具体配置

这是我最近开发的一款小程序用到的消息模板

就以我开发的 目标管理助手 小程序为例，消息模板我用了4个字段，分别为上图的thing1、thing2、date3、thing4，所以对应的参数data如下：

cloud.openapi.subscribeMessage.send({
  data: {
    thing1: {
      value: '坚持一个月上班不迟到'
    },
    thing2: {
      value: '你的好友已确认见证'
    },
    date3: {
      value: '2020-01-17 12:30:00'
    },
    thing4: {
      value: '请尽快处理哦'
    }
  },
  //  其他参数...
});

当然，上面的字段值文字只是示例，可以根据需要自由填写。

2. 调用云函数

定义好云函数之后当然还得调用云函数才行，就像我们声明一个函数后得去执行它才能生效一样。

调用云函数的方式有两种：手动调用 和 自动调用。

① 手动调用

手动调用 顾名思义就是需要用户手动触发云函数执行，如果把上面发送消息的云函数命名为sendMessage，那么部署好后我们就可以直接在用户订阅消息成功后调用它了：

wx.requestSubscribeMessage({
  tmplIds: [''],   //  需要订阅的消息模板的id的集合
  success (res) {    //  接口调用成功的回调函数

    wx.cloud.callFunction({   // 调用云函数
      // 云函数名称
      name: 'sendMessage',
      // 传给云函数的参数
      data: {
        openid: ''  // 用户openid
      },
      success: function(res) {
        console.log(res)
      }
    })

  }
})

然后云函数就可以获取到传过来的参数openid：

// ...
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.subscribeMessage.send({
        touser: event.openid,   // 接收者（用户）的 openid
        // 其他参数...
      })
    return result
  } catch (err) {
    return err
  }
}

云函数接收两个参数：event和context，而调用云函数时所传递的参数都保存在event对象中。

另外，event对象还自带一个userInfo属性，而userInfo属性下保存有小程序的appId和用户的openId，因此你也可以直接通过event.userInfo.openId的方式获取用户的openId：

const result = await cloud.openapi.subscribeMessage.send({
  touser: event.userInfo.openId,   // 接收者（用户）的 openid
  // 其他参数...
})

② 自动调用

自动调用 顾名思义就是可以由程序自动调用而无需用户手动触发，这就需要用到云函数中的 定时触发器 了，通过它可以让云函数按照某个特定的周期不断自动执行。

a) 在config.json中添加triggers字段

{
  // triggers 字段是触发器数组，目前仅支持一个触发器，即数组只能填写一个，不可添加多个
  "triggers": [
    {
      // name: 触发器的名字
      "name": "myTrigger",
      // type: 触发器类型，目前仅支持 timer (即 定时触发器)
      "type": "timer",
      // config: 触发器配置，在定时触发器下，config 格式为 cron 表达式
      "config": "0 0 2 1 * * *"
    }
  ]
}

此处代表在每月的1日的凌晨2点自动触发云函数，也就是发布订阅消息。

b) 右击config.json选择“上传触发器”

右键选择上传触发器

更多定时触发器相关内容详见→微信官方文档·小程序（https://developers.weixin.qq.com/miniprogram/dev/wxcloud/guide/functions/triggers.html）

重点总结

① 微信小程序中的订阅消息只能实现一次性订阅，而且必须通过用户手动触发订阅；
② 消息发布是通过调用云函数实现的，有手动调用和自动调用两种方式；
③ 云函数和定时触发器都必须上传之后才能使用。