appendMessage
功能介绍
为一条消息,附着另一条消息,添加至链表。可用于创建多Element消息,实现图文消息混排等效果。
为一个消息添加一系列额外的消息,一般用于消息中图文混排。
只能在创建message的阶段进行appendMessage操作。
参数详解
参数名称 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
createMessageBaseId | string | 是 | 需要添加Element的创建的消息id |
createMessageAppendId | string | 是 | 添加的创建消息id |
返回模板
V2TimValueCallback<V2TimMessage>
{
code : number
desc : string
data : {
msgID: string
timestamp: number
progress: number
sender: string
nickName: string
friendRemark: string
faceUrl: string
nameCard: string
groupID: string
userID: string
status: number
elemType: number
textElem: V2TimTextElem
customElem: V2TimCustomElem
imageElem: V2TimImageElem
soundElem: V2TimSoundElem
videoElem: V2TimVideoElem
fileElem: V2TimFileElem
locationElem: V2TimLocationElem
faceElem: V2TimFaceElem
groupTipsElem: V2TimGroupTipsElem
mergerElem: V2TimMergerElem
localCustomData: string
localCustomInt: number
cloudCustomData: string
isSelf: boolean
isRead: boolean
isPeerRead: boolean
priority: number
offlinePushInfo: V2TimOfflinePushInfo
groupAtUserList: string[]
seq: string
random: number
isExcludedFromUnreadCount: boolean
isExcludedFromLastMessage: boolean
id: string
needReadReceipt: boolean
}
}
返回值详解
名称 | 数值类型 | 描述 |
---|---|---|
code | number | 请求结果错误码 |
desc | string | 请求结果描述 |
data | V2TimMessage | 添加消息后的信息 |
代码示例
import { TencentImSDKPlugin } from 'react-native-tim-js';
// 创建文本消息
const createTextMessageRes = await TencentImSDKPlugin.v2TIMManager
.getMessageManager()
.createTextMessage(
'test' // 文本信息
);
// 创建append消息
const createAppendMessageRes = await TencentImSDKPlugin.v2TIMManager
.getMessageManager()
.createTextMessage(
'append' // 添加的文本信息
);
if (createTextMessageRes.code === 0 && createAppendMessageRes.code === 0) {
// 文本信息创建成功
const id = createTextMessageRes.data?.id;
const appendId = createAppendMessageRes.data?.id;
// 为第一个消息添加一个Text消息
const appendMessageRes = await TencentImSDKPlugin.v2TIMManager
.getMessageManager()
.appendMessage(id!, appendId!);
if (appendMessageRes.code === 0) {
// 发送文本消息
// 在sendMessage时,若只填写receiver则发个人用户单聊消息
// 若只填写groupID则发群组消息
// 若填写了receiver与groupID则发群内的个人用户,消息在群聊中显示,只有指定receiver能看见
const sendMessageRes = await TencentImSDKPlugin.v2TIMManager
.getMessageManager()
.sendMessage({ id: id!, receiver: 'userID', groupID: 'groupID' }); //注意此时的id为被添加的消息id
if (sendMessageRes.code === 0) {
// 发送成功
// append的Text消息在sendMessageRes.data.textElem.nextElem中
}
}
}