tencent cloud

文档反馈

最后更新时间:2024-01-31 16:12:00

    功能描述

    如果您想实现类似于微信的合并转发功能,需要进行以下步骤:
    1. 根据原始消息列表创建一条合并消息。
    2. 把合并消息发送到对端。
    3. 对端收到合并消息后解析出原始消息列表。
    合并消息的展示还需要标题和摘要信息,如下图所示:
    合并转发
    合并消息展示
    点击合并消息下载合并消息列表展示
    
    
    

    合并转发消息

    创建并发送合并转发消息

    我们在创建一条合并消息的时候不仅要设置合并消息列表,还要设置标题和摘要信息,实现流程如下:
    1. 调用 createMergerMessage (Details) 接口创建一条合并消息,创建合并消息的时候需要设置原始消息列表,合并消息标题、合并消息摘要等信息。
    
    属性
    含义
    说明
    msgIDList
    原始消息ID列表
    合并转发的原始消息ID列表
    title
    标题
    合并消息的标题,如上图所示 “xixiyah 和 Hello 的聊天记录”
    abstractList
    摘要列表
    合并消息的摘要信息,如上图所示,合并消息需要预先展示原始消息的摘要信息,当用户点击 Cell 后才去展示完整消息内容
    compatibleText
    兼容文本信息
    低版本 SDK 如果不支持合并消息,默认会收到一条文本消息,文本消息的内容为 compatibleText
    创建并发送合并消息示例代码如下:
    // 需要被转发的消息列表,消息列表里可以包含合并消息,不能包含群 Tips 消息
    V2TimValueCallback<V2TimMsgCreateInfoResult> createMergerMessageResult =
    await TencentImSDKPlugin.v2TIMManager
    .getMessageManager()
    .createMergerMessage(
    msgIDList: ["msgid1", "msgid2"],
    title: "user1与user2的聊天", // 合并消息标题
    abstractList: ["user1:hello", "user2:你好"], // 合并消息摘要列表
    compatibleText: "当前版本不支持该消息", // 合并消息兼容文本,低版本 SDK 如果不支持合并消息,默认会收到一条文本消息,文本消息的内容为 compatibleText
    );
    if (createMergerMessageResult.code == 0) {
    TencentImSDKPlugin.v2TIMManager.getMessageManager().sendMessage(
    id: createMergerMessageResult.data.id,
    receiver: "",
    groupID: "",
    );
    }

    接收合并转发消息

    添加监听器

    接收方调用 addAdvancedMsgListener (Details) 添加高级消息监听器。 一般建议在比较靠前的时间点调用,例如例如聊天消息界面初始化后,确保 App 能及时收到消息。
    示例代码如下:
    TencentImSDKPlugin.v2TIMManager
    .getMessageManager()
    .addAdvancedMsgListener(listener: listener);

    解析消息

    添加监听器后,接收方会在 onRecvNewMessage 中收到合并消息 V2TimMessage。 可以先通过合并消息元素 V2TimMergerElem (Details) 获取 titleabstractList UI 展示。 当用户点击合并消息的时候再调用 downloadMergerMessage(Details) 接口下载合并消息列表 UI 展示。
    示例代码如下:
    if(message.elemType == MessageElemType.V2TIM_ELEM_TYPE_MERGER){
    message.mergerElem.abstractList;
    message.mergerElem.isLayersOverLimit;
    message.mergerElem.title;
    V2TimValueCallback<List<V2TimMessage>> download = await TencentImSDKPlugin.v2TIMManager.getMessageManager().downloadMergerMessage(msgID: message.msgID,);
    if(download.code == 0){
    List<V2TimMessage> messageList = download.data;
    }
    }

    逐条转发消息

    如果您需要转发单条消息,可以先通过 createForwardMessage (Details) 接口创建一条和原消息内容完全一样的转发消息,再调用 sendMessage (Details) 接口把转发消息发送出去。
    示例代码如下:
    // 创建转发消息,转发消息的 elem 内容和原消息完全一致
    V2TimValueCallback<V2TimMsgCreateInfoResult> createForwardMessageRes = await TencentImSDKPlugin.v2TIMManager.getMessageManager().createForwardMessage(msgID: "msgid");
    // 发送消息给用户 "denny"
    if(createForwardMessageRes.code == 0){
    TencentImSDKPlugin.v2TIMManager.getMessageManager().sendMessage(id: createForwardMessageRes.data.id, receiver: "denny", groupID: "");
    }
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持