wechatSubscribeMessageInMiniapp
微信小程序订阅消息请求适配器,被 showWxSubscribeMessage 内部调用。
前置依赖
typescript
interface SubscribeMessageInMiniappDeps {
requestSubscribeMessage: UniApp['requestSubscribeMessage']
log: Console['log']
error: Console['error']
}| 依赖 | 说明 |
|---|---|
requestSubscribeMessage | 小程序订阅消息 API |
log / error | 成功 / 失败日志 |
wechatSubscribeMessageInMiniapp
函数签名
typescript
function wechatSubscribeMessageInMiniapp(
options?: SubscribeMessageOptions,
deps: SubscribeMessageInMiniappDeps
): Promise<SubscribeMessageResult>参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
options.tmplIds | string[] | 是* | 模板 ID 列表;与 tmplId 二选一 |
options.tmplId | string | 是* | 单个模板 ID,会转为单元素数组 |
deps | SubscribeMessageInMiniappDeps | 是 | 环境依赖 |
* 至少提供一个模板 ID;单次最多 3 个。
返回值
| 类型 | 说明 |
|---|---|
Promise<SubscribeMessageResult> | 含各模板 ID 对应的订阅状态('accept' / 'reject' 等)及 raw |
工作原理
- 从
tmplIds或tmplId归一化模板列表;空列表 reject。 - 超过 3 个模板 reject(微信单次上限)。
- 调用
requestSubscribeMessage({ tmplIds }),成功时将响应展开到结果对象(键为模板 ID)。 - 用户拒绝某模板不会导致 Promise reject,状态体现在对应 tmplId 字段值中。