微信小程序
动态消息
# 动态消息
从基础库 2.4.0 开始,支持转发动态消息。动态消息对比普通消息,有以下特点:
- 消息发出去之后,开发者可以通过后台接口修改部分消息内容。
- 消息有对应的提醒按钮,用户点击提醒按钮可以订阅提醒,开发者可以通过后台修改消息状态并推送一次提醒消息给订阅了提醒的用户
# 消息属性
动态消息有状态、文字内容、文字颜色、系统消息提醒。
# 模板
动态消息目前有两个模板,应用于组队场景,分别以‘开始时’和‘到齐时’为状态变更和提醒节点。
# 状态
每个模板有三个状态,分别有其对应的文字内容和颜色。其中状态 0 可以转移到状态 0 和 1 和 2,状态 1 可以转移到状态 2,状态 2 不可以转移。
‘开始时’
‘成员到齐时’
保持状态 0 无数据传入或状态 1 24h后自动进入状态 2。
# 状态参数
每个状态转移的时候可以携带参数,具体参数说明如下。
# 系统消息
用户点击含动态消息的卡片退出小程序后会下发系统消息,状态转移的时候会变更系统消息内容或下发新的系统消息,具体的消息内容如下。
# 使用方法
# 一、创建 activity_id
每条动态消息可以理解为一个活动,活动发起前需要通过 createActivityId 接口创建 activity_id
。后续转发动态消息以及更新动态消息都需要传入这个 activity_id
。
# 二、在转发之前声明消息类型为动态消息
通过调用 wx.updateShareMenu 接口,传入 isUpdatableMessage: true
,以及 templateInfo
、activityId
参数。其中 activityId
从步骤一中获得。
wx.updateShareMenu({
withShareTicket: true,
isUpdatableMessage: true,
activityId: '', // 活动 ID
templateInfo: {
parameterList: [{
name: 'member_count',
value: '1'
}, {
name: 'room_limit',
value: '3'
}]
templateld: '21B034D08C5615B9889CE362BB957B1EE69A584B'
}
})
# 三、修改动态消息内容
动态消息发出去之后,可以通过 setUpdatableMsg 修改消息内容。
# 低版本兼容
对于不支持动态消息的客户端版本,收到动态消息后会展示成普通消息