微信小程序订阅消息

本文是 《三方登录》 的延伸，讲解 yudao-mall-uniapp 商城小程序如何实现微信 小程序 订阅消息的功能。对应的官方文档如下：

• 《【开发指南】订阅消息》
• 《【前端】订阅消息》
• 《【服务端】订阅消息》

1. 小程序准备

1.1 模版申请

目前订阅消息，无法使用之前的“测试小程序”，必须进行正式小程序的申请！

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

上图可以看到三个模版，是目前项目已经接入的订阅消息：

• 【商城】订单发货通知：管理员在后台发货后，通知用户

• 【商城】拼团结果通知：用户拼团成功后，通知用户

• 【支付】充值成功通知：用户充值成功后，通知用户

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

1.2 后端配置

在后端 发送订阅消息 时，需要传递 miniprogram_state 参数，用于区分跳转小程序类型：

• developer 为开发版
• trial 为体验版
• formal 为正式版

因此，在 application-${profile}.yaml 配置文件中，有对应的 yudao.wxa-subscribe-message.miniprogram-state 配置项，如下图所示：

一般情况下，如果是开发测试，不用修改，直接使用默认的 developer 即可。

2. 功能演示 & 代码实现

本小节，我们以【商城】订单发货通知为例，演示如何实现订阅消息的功能。在开始之前，你需要做如下事情：

• 参考 《快速启动【前端】》 文档，把 yudao-uniapp-mall 商城项目跑起来，并使用 HBuilderX + 微信开发者工具进行调试
• 参考 《商城功能开启》 文档，开启商城功能
• 在 [微信小程序 -> 功能 -> 订阅消息] 菜单，配置好“订单发货通知”模版

2.1 uni-app 获取订阅模版列表

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

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

2.2 uni-app 发起订阅消息

第一步，在 uni-app 中，下单并完成支付，然后会进入支付成功页。如下图所示：

第二步，点击【立即订阅】按钮，发起对“订单发货通知”的订阅消息。如下图所示：

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

2.3 后端发送订阅消息

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

它的内部，通过调用项目的 SocialClientApi 的 #sendWxaSubscribeMessage(...) 方法，从而调用微信的 发送订阅消息 接口，发送订阅消息的请求。

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

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

3. 其它业务如何接入？

参考上述小节的内容：

• 第一步，在 uni-app 项目中，需要调用项目的 sheep/platform/provider/wechat/miniProgram.js 的 #subscribeMessage(...) 方法，发起订阅
• 第二步，在后端项目中，需要调用 SocialClientApi 的 #sendWxaSubscribeMessage(...) 方法，发送订阅消息

当然，肯定需要在微信小程序那，配置对应的订阅消息模版。