insertC2CMessageToLocalStorage
功能介绍
向C2C消息列表中添加一条消息
只能插入文本消息,参数data为本文内容
该接口主要用于满足向C2C聊天会话中插入一些提示性消息的需求,比如“您已成功发送消息”,这类消息有展示 在聊天消息区的需求,但并没有发送给其他人的必要。
insertC2CMessageToLocalStorage() 相当于一个被禁用了网络发送能力的 sendMessage() 接口。
通过该接口 insert 的消息只存本地,程序卸载后会丢失。
web不支持该接口
参数详解
参数名称 | 参数类型 | 是否必填 | 平台 | 描述 |
---|---|---|---|---|
data | String | 是 | 全部 | 文本消息内容 |
userID | String | 是 | 全部 | 发送对象id |
sender | 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 | 创建后的插入信息 |
代码示例
// 向C2C消息列表中添加一条消息
V2TimValueCallback<V2TimMessage> insertC2CMessageToLocalStorageRes =
await TencentImSDKPlugin.v2TIMManager
.getMessageManager()
.insertC2CMessageToLocalStorage(
data: "data", // 文本消息内容
userID: "userID", // 接受信息用户id
sender: "sender" // 发送者id
);
if (insertC2CMessageToLocalStorageRes.code == 0) {
//添加成功
}