微信小程序订阅消息

前置阅读文章：
- 《用户体系》
- 《三方登录》
本文是 《三方登录》 的延伸，讲解dtpc-mall-uniapp (opens new window)商城小程序如何实现微信 小程序 订阅消息的功能。对应的官方文档如下：

[《【开发指南】订阅消息》](http://https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/subscribe-message-overview.html "《【开发指南】订阅消息》")
[《【前端】订阅消息》](http://https://developers.weixin.qq.com/miniprogram/dev/api/open-api/subscribe-message/wx.requestSubscribeMessage.html "《【前端】订阅消息》")
[《【服务端】订阅消息》](http://https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/mp-message-management/subscribe-message/deleteMessageTemplate.html "《【服务端】订阅消息》")

## 1. 小程序准备
### 1.1 模版申请

申请后，可以在 [微信小程序 -> 功能 -> 订阅消息] 菜单，申请对应的订阅消息模版。如下图所示：

![](/media/202408/2024-08-28_134536_633696.png)

上图可以看到三个模版，是目前项目已经接入的订阅消息：
- 【商城】订单发货通知：管理员在后台发货后，通知用户

![](/media/202408/2024-08-28_134600_667127.png)
- 【商城】拼团结果通知：用户拼团成功后，通知用户

![](/media/202408/2024-08-28_134608_026548.png)
- 【支付】充值成功通知：用户充值成功后，通知用户

![](/media/202408/2024-08-28_134627_017737.png)

而这些模版，我们是无法编辑，而是在【公共模板库】选用后，进入【我的模版】。

## 1.2 后端配置
在后端 发送订阅消息 (opens new window)时，需要传递 miniprogram_state 参数，用于区分跳转小程序类型：

- developer 为开发版
- trial 为体验版
- formal 为正式版
因此，在 application-${profile}.yaml 配置文件中，有对应的dtpc.wxa-subscribe-message.miniprogram-state 配置项，如下图所示：

![](/media/202408/2024-08-28_134656_843314.png)

## 2. 功能演示 & 代码实现
本小节，我们以【商城】订单发货通知为例，演示如何实现订阅消息的功能。在开始之前，你需要做如下事情：
- 参考 《快速启动【前端】》 文档，把dtpc-uniapp-mall 商城项目跑起来，并使用 HBuilderX + 微信开发者工具进行调试
- 参考 《商城功能开启》 文档，开启商城功能
- 在 [微信小程序 -> 功能 -> 订阅消息] 菜单，配置好“订单发货通知”模版

### 2.1 uni-app 获取订阅模版列表
在 uni-app 打开时，会调用后端的 AppSocialUserController 的 #getSubscribeTemplateList() 方法，获取订阅消息模版列表。

目的是，uni-app 在调用 wx.requestSubscribeMessage(Object object) (opens new window)发起订阅消息时，需要传递 tmplIds 消息模版的编号。

### 2.2 uni-app 发起订阅消息
第一步，在 uni-app 中，下单并完成支付，然后会进入支付成功页。如下图所示：

![](/media/202408/2024-08-28_134833_268314.png)
第二步，点击【立即订阅】按钮，发起对“订单发货通知”的订阅消息。如下图所示：

![](/media/202408/2024-08-28_134843_174093.png)

它的实现，通过调用项目的 sheep/platform/provider/wechat/miniProgram.js 的 #subscribeMessage(...) 方法，从而调用微信的 wx.requestSubscribeMessage(Object object) 方法，发起订阅消息的请求。

### 2.3 后端发送订阅消息
第一步，在管理后台，点击 [商城系统 -> 订单中心 -> 订单列表] 菜单，找到对应的订单，点击【发货】按钮，发起对订单的发货操作。如下图所示：

![](/media/202408/2024-08-28_134915_118481.png)
它的内部，通过调用项目的 SocialClientApi 的 #sendWxaSubscribeMessage(...) 方法，从而调用微信的 发送订阅消息 (opens new window)接口，发送订阅消息的请求。

第二步，拿出手机微信（PC 电脑上看不到），在【服务通知】中，可以看到对应的订阅消息。如下图所示：

![](/media/202408/2024-08-28_134928_724923.png)

如果没有收到订阅消息，可以在 IDEA 控制台，搜 [sendSubscribeMessage] 关键字，查看是否有异常日志输出。

## 3. 其它业务如何接入？
参考上述小节的内容：

- 第一步，在 uni-app 项目中，需要调用项目的 sheep/platform/provider/wechat/miniProgram.js 的 #subscribeMessage(...) 方法，发起订阅
- 第二步，在后端项目中，需要调用 SocialClientApi 的 #sendWxaSubscribeMessage(...) 方法，发送订阅消息
 当然，肯定需要在微信小程序那，配置对应的订阅消息模版。