createMergerMessage

功能介绍

创建合并消息

如果您想实现类似于微信的合并转发功能,需要进行以下步骤:

  1. 调用 createMergerMessage 创建一条合并消息 V2TIMMessage。

  2. 调用 sendMessage 发送转发消息 V2TIMMessage。

收到合并消息解析步骤:

  1. 通过 V2TIMMessage 获取 mergerElem。

  2. 通过 mergerElem 获取 title 和 abstractList UI 展示。

  3. 当用户点击摘要信息 UI 的时候,调用 downloadMessageList 接口获取转发消息列表。

参数详解

参数名称 参数类型 是否必填 描述
msgIDList string[] 原始消息ID列表
title string 标题
abstractList string[] 摘要列表
compatibleText string 兼容文本信息,低版本 SDK 如果不支持合并消息,默认会收到一条文本消息,文本消息的内容为 compatibleText

返回模板

V2TimValueCallback<V2TimMsgCreateInfoResult>

{
    code: number,
    desc: string,
    data: {
        id: string,
        messageInfo: V2TimMessage,
    }
}

返回值详解

名称 数值类型 描述
code number 请求结果错误码
desc string 请求结果描述
data V2TimMsgCreateInfoResult 创建后的合并信息

代码示例

import { TencentImSDKPlugin } from 'react-native-tim-js';

// 创建合并消息
const createMergerMessageResult = await TencentImSDKPlugin.v2TIMManager
    .getMessageManager()
    .createMergerMessage(
        // 需要合并的消息id列表,需要被转发的消息列表,消息列表里可以包含合并消息,不能包含群 Tips 消息 messageId为消息发送后服务端创建的messageid,不是创建消息时的消息id
        ['msgid1', 'msgid2'],
        'user1与user2的聊天', // 合并消息标题
        ['user1:hello', 'user2:你好'], // 合并消息摘要列表
        '当前版本不支持该消息' // 合并消息兼容文本,低版本 SDK 如果不支持合并消息,默认会收到一条文本消息,文本消息的内容为 compatibleText
    );
if (createMergerMessageResult.code === 0) {
    // 发送合并消息
    // 在sendMessage时,若只填写receiver则发个人用户单聊消息
    //                 若只填写groupID则发群组消息
    //                 若填写了receiver与groupID则发群内的个人用户,消息在群聊中显示,只有指定receiver能看见
    TencentImSDKPlugin.v2TIMManager.getMessageManager().sendMessage({
        id: createMergerMessageResult.data!.id!,
        receiver: 'receiver',
        groupID: 'groupID',
    });
}

results matching ""

    No results matching ""