微信小程序私密消息
小程序私密消息功能是这样一种能力:当分享者分享小程序卡片给其他用户或者微信群后,其他用户点击此小程序卡片时,开发者可以鉴别出点击卡片的用户是否被分享者分享过小程序卡片。具体使用说明和步骤可以参考微信小程序私密消息文档。
SDK version >= 3.20.1
创建私密消息的 activity_id
wx.BaaS.wxCreateActivityID()
返回字段说明
属性 | 类型 | 说明 |
---|---|---|
activity_id | String | 消息的 ID |
expiration_time | Number | activity_id 的过期时间戳。默认 24 小时后过期 |
errcode | Number | 错误码 |
返回示例
{
"activity_id": "",
"expiration_time": "",
"errcode": ""
}
示例代码
创建私密消息的 activity_id ,并通过 wx.updateShareMenu 接口声明本次分享的消息为私密消息。
wx.BaaS.wxCreateActivityID().then((res) => {
if (res.data.activity_id) {
// 声明本次分享的消息为私密消息
wx.updateShareMenu({
withShareTicket: true,
isPrivateMessage: true,
activityId: res.data.activity_id,
});
}
});
分享后,用户点开消息卡片进入小程序,在 onShow 中取到 shareTicket ,通过 wx.authPrivateMessage 接口可以验证当前用户是否是私密消息的接收者。
// app.js
App({
onShow(options) {
this.shareTicket = options.shareTicket;
},
});
const app = getApp();
// 验证当前用户是否是私密消息的接收者
wx.authPrivateMessage({
shareTicket: app.shareTicket,
success(res) {
const { valid } = res;
console.log("验证是否通过 ==>", valid);
},
});