之前的模板消息推送,將在2020年1月10日下線,所以我們不得不使用訂閱消息了。
我們先來看下訂閱消息的官方簡介。
接下來我們就來藉助雲開發,來快速實現小程序消息推送的功能。
一:獲取模板 ID
這一步和我們之前的模板消息推送是一樣的,也是先添加模板,然後拿到模板id
首先是開通訂閱消息功能,很簡單,如下圖
由於長期性訂閱消息,目前僅向政務民生、醫療、交通、金融、教育等線下公共服務開放,後期將逐步支持到其他線下公共服務業務。僅就線下公共服務這一點,長期性訂閱消息就和大部分開發者無緣了。
所以我們這裏只能以使用一次性訂閱消息爲例。
如上圖,我們從公共模板庫裏選擇一個一次性訂閱的模板。然後編輯模板如下圖
下圖就是我們添加好的模板,下圖的模板id就是我們需要的。
二,請求用戶授權
我們做訂閱消息授權時,只能是用戶點擊或者支付完成後纔可以調起來授權彈窗,官方是這麼要求的:
我們這裏用到了wx.requestSubscribeMessage這個方法,來獲取用戶的授權。
- 1,編寫index.wxml代碼
- 2,編寫index.js代碼,實現點擊獲取授權
這一步tmplIds裏的一串字符,就是我們自己添加的模板id - 3,點擊按鈕運行效果如下
開發者工具模擬器上點擊授權彈窗是這樣的:
手機上的授權彈窗是這樣的:
可以看到,這裏顯示的就是我們添加的 ‘上課提醒’的模板。
細心的同學可以看到, 真機上多了一個 ‘總是保持以上選擇,不再詢問’
其實,你自己仔細多品一些。也能明天,我們正常訂閱消息授權時,用戶允許的話,你只能推送一次消息。也就是用戶允許一次,我們就可以推送一條消息給用戶,並且這個允許不存在過期。所以我們可以讓用戶儘量多的點擊允許,這樣我們就可以儘量多的給用戶發送消息了。
這裏用戶允許後,我們就可以給用戶推送消息了,接下來我們來藉助雲開發的雲函數來實現消息推送功能。
三,獲取用戶的opneid
先來看官方爸爸是怎麼說的。
可以看出官方提供了兩種方式,我們這裏使用雲調用。說白了就是在雲函數裏調用推送功能。
- 推送所需參數
可以看到我這裏用來openapi功能,並且需要用到用戶的opneid,關於openid的獲取,我之前有寫過文章,也錄過視頻的。文章的話,大家去翻下我歷史的文章,視頻的話,點擊這個即可:《藉助雲函數獲取用戶openid》
這裏的openid的獲取我就不再詳細講解了,把對應雲函數的代碼給大家貼出來。
在使用雲開發時,有幾點需要注意的 - 1,需要在project.config.json裏創建雲函數目錄如下圖
- 2,需要在app.js裏初始化雲開發環境
至於雲開發的環境id從哪裏拿,我視頻裏也講過很多遍了,直接去看我視頻或者翻看我歷史文章即可。
《零基礎入門雲開發視頻》
四,用雲函數實現消息推送
我們只需要創建一個雲函數如下,然後填入用戶的openid,要跳轉的小程序頁面鏈接,模板內容,模板id即可。通常這些數據都應該傳進來,簡單起見,我就把這裏的模板內容寫成固定的。
注意:我在編寫上面的代碼時,推送內容的key必須和小程序模板裏的key保持一致,否則就會報如下錯誤。
- 然後看下調用這個雲函數的地方
如果用戶沒有授權,我們推送會報如下錯誤
如果用戶授權過,我們就可以成功推送了,推送後的打印日誌如下
還記得我們真機上的授權嗎,如果用戶只是點擊了允許,沒有選擇一直允許,那我我們在推送成功一次後,如果再次推送,就需要用戶重新授權。否則,還是會報這個錯誤的
所以我們用戶點擊一次允許,我們就可以推送一次消息,比如,我點擊了4次允許那麼我就可以成功的推送4次
效果圖
可以看到,我們成功的收到 上課提醒的模板消息,點擊進去,就是我們具體的推送內容
其實我這是連續收到了4條消息,因爲我點擊了4次允許推送,所以就可以成功的推送4次。
到這裏我們就完整的實現模板消息推送功能了,下面我把主要代碼貼給大家,大家也可以私信我獲取完整源碼。
- index.wxml
<button bindtap="shouquan" type='primary'>獲取訂閱消息授權</button>
<button bindtap="getOpenid">獲取用戶的openid並推送消息</button>
- index.js
//編程小石頭wechat:2501902696
Page({
//獲取授權的點擊事件
shouquan() {
wx.requestSubscribeMessage({
tmplIds: ['CFeSWarQLMPyPjwmiy6AV4eB-IZcipu48V8bFLkBzTU'], //這裏填入我們生成的模板id
success(res) {
console.log('授權成功', res)
},
fail(res) {
console.log('授權失敗', res)
}
})
},
//獲取用戶的openid
getOpenid() {
wx.cloud.callFunction({
name: "getopenid"
}).then(res => {
let openid = res.result.openid
console.log("獲取openid成功", openid)
this.send(openid)
}).catch(res => {
console.log("獲取openid失敗", res)
})
},
//發送模板消息到指定用戶,推送之前要先獲取用戶的openid
send(openid) {
wx.cloud.callFunction({
name: "sendMsg",
data: {
openid: openid
}
}).then(res => {
console.log("推送消息成功", res)
}).catch(res => {
console.log("推送消息失敗", res)
})
}
})
- 推送對應的雲函數
//編程小石頭wechat:2501902696
const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async(event, context) => {
try {
const result = await cloud.openapi.subscribeMessage.send({
touser: event.openid, //要推送給那個用戶
page: 'pages/index/index', //要跳轉到那個小程序頁面
data: {//推送的內容
thing1: {
value: '小程序入門課程'
},
thing6: {
value: '杭州浙江大學'
},
thing7: {
value: '第一章第一節'
}
},
templateId: 'CFeSWarQLMPyPjwmiy6AV4eB-IZcipu48V8bFLkBzTU' //模板id
})
console.log(result)
return result
} catch (err) {
console.log(err)
return err
}
}
後面我會分享更多小程序相關的知識出來,請持續關注。
相關視頻講解:https://edu.csdn.net/course/detail/26572