建站
咨詢
售后
建站咨詢
新聞中心
這里有您想知道的互聯(lián)網(wǎng)營銷解決方案
創(chuàng)新互聯(lián)小程序教程：微信小程序API訂閱消息
wx.requestSubscribeMessage(Object object)
基礎(chǔ)庫 2.4.4 開始支持，低版本需做 兼容處理。
調(diào)起客戶端小程序訂閱消息界面，返回用戶訂閱消息的操作結(jié)果。當(dāng)用戶勾選了訂閱面板中的“總是保持以上選擇，不再詢問”時(shí)，模板消息會被添加到用戶的小程序設(shè)置頁，通過 wx.getSetting 接口可獲取用戶對相關(guān)模板消息的訂閱狀態(tài)。
注意事項(xiàng)
- 一次性模板 id 和永久模板 id 不可同時(shí)使用。
- 低版本基礎(chǔ)庫2.4.4~2.8.3 已支持訂閱消息接口調(diào)用，僅支持傳入一個(gè)一次性 tmplId / 永久 tmplId。
- 2.8.2 版本開始，用戶發(fā)生點(diǎn)擊行為或者發(fā)起支付回調(diào)后，才可以調(diào)起訂閱消息界面。
- 2.10.0 版本開始，開發(fā)版和體驗(yàn)版小程序?qū)⒔故褂媚０逑?formId。
參數(shù)
Object object
| 屬性 | 類型 | 默認(rèn)值 | 必填 | 說明 |
|---|---|---|---|---|
| tmplIds | Array | 是 | 需要訂閱的消息模板的id的集合，一次調(diào)用最多可訂閱3條消息（注意：iOS客戶端7.0.6版本、Android客戶端7.0.7版本之后的一次性訂閱/長期訂閱才支持多個(gè)模板消息，iOS客戶端7.0.5版本、Android客戶端7.0.6版本之前的一次訂閱只支持一個(gè)模板消息）消息模板id在[微信公眾平臺(mp.weixin.qq.com)-功能-訂閱消息]中配置 | |
| success | function | 否 | 接口調(diào)用成功的回調(diào)函數(shù) | |
| fail | function | 否 | 接口調(diào)用失敗的回調(diào)函數(shù) | |
| complete | function | 否 | 接口調(diào)用結(jié)束的回調(diào)函數(shù)（調(diào)用成功、失敗都會執(zhí)行） |
object.success 回調(diào)函數(shù)
參數(shù)
Object res
| 屬性 | 類型 | 說明 |
|---|---|---|
| errMsg | String | 接口調(diào)用成功時(shí)errMsg值為'requestSubscribeMessage:ok' |
| TEMPLATE_ID | String | [TEMPLATE_ID]是動(dòng)態(tài)的鍵，即模板id，值包括'accept'、'reject'、'ban'。'accept'表示用戶同意訂閱該條id對應(yīng)的模板消息，'reject'表示用戶拒絕訂閱該條id對應(yīng)的模板消息，'ban'表示已被后臺封禁。例如 { errMsg: "requestSubscribeMessage:ok", zun-LzcQyW-edafCVvzPkK4de2Rllr1fFpw2A_x0oXE: "accept"} 表示用戶同意訂閱zun-LzcQyW-edafCVvzPkK4de2Rllr1fFpw2A_x0oXE這條消息 |
object.fail 回調(diào)函數(shù)
參數(shù)
Object res
| 屬性 | 類型 | 說明 |
|---|---|---|
| errMsg | String | 接口調(diào)用失敗錯(cuò)誤信息 |
| errCode | Number | 接口調(diào)用失敗錯(cuò)誤碼 |
錯(cuò)誤碼
| errCode | errMsg | 說明 |
|---|---|---|
| 10001 | TmplIds can't be empty | 參數(shù)傳空了 |
| 10002 | Request list fail | 網(wǎng)絡(luò)問題，請求消息列表失敗 |
| 10003 | Request subscribe fail | 網(wǎng)絡(luò)問題，訂閱請求發(fā)送失敗 |
| 10004 | Invalid template id | 參數(shù)類型錯(cuò)誤 |
| 10005 | Cannot show subscribe message UI | 無法展示 UI，一般是小程序這個(gè)時(shí)候退后臺了導(dǎo)致的 |
| 20001 | No template data return, verify the template id exist | 沒有模板數(shù)據(jù)，一般是模板 ID 不存在 或者和模板類型不對應(yīng) 導(dǎo)致的 |
| 20002 | Templates type must be same | 模板消息類型 既有一次性的又有永久的 |
| 20003 | Templates count out of max bounds | 模板消息數(shù)量超過上限 |
| 20004 | The main switch is switched off | 用戶關(guān)閉了主開關(guān)，無法進(jìn)行訂閱 |
| 20005 | This mini program was banned from subscribing messages | 小程序被禁封 |
示例代碼
wx.requestSubscribeMessage({
tmplIds: [''],
success (res) { }
})新聞標(biāo)題：創(chuàng)新互聯(lián)小程序教程：微信小程序API訂閱消息
分享URL：http://www.5511xx.com/article/djchjij.html
