createMergerMessage
功能介绍
创建合并消息
如果您想实现类似于微信的合并转发功能,需要进行以下步骤:
调用 createMergerMessage 创建一条合并消息 V2TIMMessage。
调用 sendMessage 发送转发消息 V2TIMMessage。
收到合并消息解析步骤:
通过 V2TIMMessage 获取 mergerElem。
通过 mergerElem 获取 title 和 abstractList UI 展示。
当用户点击摘要信息 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',
});
}