新聞中心
這里有您想知道的互聯(lián)網(wǎng)營銷解決方案
創(chuàng)新互聯(lián)小程序教程:微信小程序API訂閱消息
wx.requestSubscribeMessage(Object object)
基礎(chǔ)庫 2.4.4 開始支持,低版本需做 兼容處理。
調(diào)起客戶端小程序訂閱消息界面,返回用戶訂閱消息的操作結(jié)果。當用戶勾選了訂閱面板中的“總是保持以上選擇,不再詢問”時,模板消息會被添加到用戶的小程序設(shè)置頁,通過 wx.getSetting 接口可獲取用戶對相關(guān)模板消息的訂閱狀態(tài)。
注意事項
- 一次性模板 id 和永久模板 id 不可同時使用。
- 低版本基礎(chǔ)庫2.4.4~2.8.3 已支持訂閱消息接口調(diào)用,僅支持傳入一個一次性 tmplId / 永久 tmplId。
- 2.8.2 版本開始,用戶發(fā)生點擊行為或者發(fā)起支付回調(diào)后,才可以調(diào)起訂閱消息界面。
- 2.10.0 版本開始,開發(fā)版和體驗版小程序?qū)⒔故褂媚0逑?formId。
參數(shù)
Object object
| 屬性 | 類型 | 默認值 | 必填 | 說明 |
|---|---|---|---|---|
| tmplIds | Array | 是 | 需要訂閱的消息模板的id的集合,一次調(diào)用最多可訂閱3條消息(注意:iOS客戶端7.0.6版本、Android客戶端7.0.7版本之后的一次性訂閱/長期訂閱才支持多個模板消息,iOS客戶端7.0.5版本、Android客戶端7.0.6版本之前的一次訂閱只支持一個模板消息)消息模板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)用成功時errMsg值為'requestSubscribeMessage:ok' |
| TEMPLATE_ID | String | [TEMPLATE_ID]是動態(tài)的鍵,即模板id,值包括'accept'、'reject'、'ban'。'accept'表示用戶同意訂閱該條id對應的模板消息,'reject'表示用戶拒絕訂閱該條id對應的模板消息,'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)用失敗錯誤信息 |
| errCode | Number | 接口調(diào)用失敗錯誤碼 |
錯誤碼
| errCode | errMsg | 說明 |
|---|---|---|
| 10001 | TmplIds can't be empty | 參數(shù)傳空了 |
| 10002 | Request list fail | 網(wǎng)絡問題,請求消息列表失敗 |
| 10003 | Request subscribe fail | 網(wǎng)絡問題,訂閱請求發(fā)送失敗 |
| 10004 | Invalid template id | 參數(shù)類型錯誤 |
| 10005 | Cannot show subscribe message UI | 無法展示 UI,一般是小程序這個時候退后臺了導致的 |
| 20001 | No template data return, verify the template id exist | 沒有模板數(shù)據(jù),一般是模板 ID 不存在 或者和模板類型不對應 導致的 |
| 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),無法進行訂閱 |
| 20005 | This mini program was banned from subscribing messages | 小程序被禁封 |
示例代碼
wx.requestSubscribeMessage({
tmplIds: [''],
success (res) { }
}) 網(wǎng)站欄目:創(chuàng)新互聯(lián)小程序教程:微信小程序API訂閱消息
鏈接分享:http://m.fisionsoft.com.cn/article/djchjij.html


咨詢
建站咨詢

