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