# 动态消息

# 动态消息

游戏内的转发消息，可升级为「动态消息」。动态消息 对比 普通转发消息，有以下特点：

1.动态消息，可添加副标题。用户转发出去后，开发者可以通过后台，更新副标题。

2.开发者 可通过后台修改用户状态，推送 系统提醒 给用户

# 聊天模式的动态消息

基础库 3.7.12 开始支持，从 聊天模式 中 通过wx.shareAppMessageToGroup发送的小程序卡片，可以获得动态消息能力，用户表现包括：

1、小程序卡片上的辅标题可以动态更新

2、可以在聊天中下发系统消息，内容为：成员A+“完成了”/"参与了"+成员B+“发布的”+打开小程序的文字链，如「alex 完成了 cindy 发布的 团建报名统计」

# 使用方法

第一步：创建activity_id

服务端通过 创建activity_id接口 创建activity_id 声明分享卡片为动态消息

第二步：声明分享卡片为动态消息

前端在调用wx.shareAppMessageToGroup 前，通过 wx.updateShareMenu ，声明要分享的卡片为动态消息，请求参数如下

注意事项：

1.useForChatTool 为 true 时，chooseType 和 participant 才会生效

2.chooseType = 1，表示按指定的 participant 当作参与者

3.chooseType = 2，表示群内所有成员均为参与者（包括后加入群）

wx.updateShareMenu({
        withShareTicket: true,
        isUpdatableMessage: true,
        activityId: 'xxx',
        useForChatTool: true,
        chooseType: 1,
        participant: that.data.members,
        templateInfo: {
          templateId:    '4A68CBB88A92B0A9311848DBA1E94A199B166463'
        },
)

有 2 个模版可使用，模版区别（target_state与participator_state含义见第三布）：

第三步：更新活动状态或用户完成情况

服务端通过 setChatToolMsg 接口更新活动状态活用户完成情况。也可通过云开发 chattoolmsg.send 接口调用更新 调用示例：

//变更单个成员状态，会触发提醒「 aaa 已参与 bbb 发布的 xxxx 」
{
    "activity_id": "xxx",
    "target_state":1,
    "version_type": 0,
    "participator_info_list": [
        {
            "group_openid": "aaa",
            "state": 1
        },
        {
            "group_openid": "bbb",
            "state": 1

        }
    ]
}
//变更动态消息状态，会触发提醒「 bbb 发布的 xxxx 已结束」
{
    "activity_id": "xxx",
    "target_state":3,
    "version_type": 0,
}

# 非聊天模式的动态消息

基础库 2.4.0 开始支持。卡片可更新已参与人数 和状态。同时，当用户转发消息到会话后，可通过「提醒我」房间游戏开始提醒。

# 消息状态

消息有两个状态，对应游戏房间状态，分别有其对应的文字内容和颜色。其中状态 0 可以转移到状态 0 和 1，状态 1 无法再转移。

# 状态转移参数

每个状态转移的时候可以携带参数，具体参数说明如下。

# 使用方法

第一步：创建 activity_id

每条动态消息可以理解为一个活动，活动发起前需要通过 wx.updateShareMenu 接口创建 activity_id。后续转发动态消息以及更新动态消息都需要传入这个 activity_id。

活动的默认有效期是 24 小时。活动结束后，消息内容会变成统一的样式：

●文字内容：“已结束”

●文字颜色：#00ff00

第二步：在转发之前声明消息类型为动态消息

通过调用 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'
    }]
  }
})

第三步：修改动态消息内容

动态消息发出去之后，可以通过 updatableMessage.setUpdatableMsg 修改消息内容。

# 低版本兼容

对于不支持动态消息的客户端版本，收到动态消息后会展示成普通消息