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