跳到主要内容

消息介绍

消息基本结构

属性名类型说明
conversationTypeRCIMIWConversationType会话类型
messageTypeRCIMIWMessageType消息的类型
targetIdstring会话 ID
channelIdstring所属会话的业务标识,长度限制 20 字符
messageIdnumber本地数据库中存储的消息的唯一 ID 值。发送新消息时无需指定该 ID,否则会导致消息入库失败。在失败重发消息时,可以填入已入库的消息的 ID,请确保使用上一次发送失败的消息实例。
messageUIdstring服务器消息唯一 ID(在同一个 Appkey 下全局唯一)
offLineboolean是否是离线消息,只在接收消息的回调方法中有效,如果消息为离线消息,则为 YES ,其他情况均为 NO
groupReadReceiptInfoRCIMIWGroupReadReceiptInfo群阅读回执状态
receivedTimenumber消息的接收时间(Unix 时间戳、毫秒)
sentTimenumber消息的发送时间(Unix 时间戳、毫秒)
receivedStatusRCIMIWReceivedStatus消息的接收状态
sentStatusRCIMIWSentStatus消息的发送状态
senderUserIdstring消息的发送者 ID
directionRCIMIWMessageDirection消息的方向
userInfoRCIMIWUserInfo消息携带的用户信息
mentionedInfoRCIMIWMentionedInfo消息的 @ 信息
pushOptionsRCIMIWMessagePushOptions消息推送配置
extrastring消息的附加字段
expansionMap<string, string>消息扩展信息列表,该属性在消息发送时确定,发送之后不能再做修改
扩展信息只支持单聊和群组,其它会话类型不能设置扩展信息
默认消息扩展字典 key 长度不超过 32 ,value 长度不超过 4096 ,单次设置扩展数量最大为 20,消息的扩展总数不能超过 300

消息类型

IMLib 的消息类型(RCIMIWMessageType)枚举提供了预定义的文本、语音、图片等消息类型,并且支持 App 通过 RCIMIWMessageType.custom 实现自定义消息。

各类型消息默认会在客户端本地存储,计入未读消息数。以下类型除外:

  • 撤回消息类型(RCIMIWMessageType.recall):客户端本地存储,但不计入未读消息数
  • 命令消息类型(RCIMIWMessageType.command):客户端不进行本地存储,不计入未读消息数
  • 命令通知消息类型(RCIMIWMessageType.commandNotification):客户端本地存储,不计入未读消息数。
  • 自定义消息类型(RCIMIWMessageType.custom):由 App 自定义存储策略(RCIMIWCustomMessagePolicy)进行控制。

文本消息

类型:RCIMIWMessageType.text

专有可访问属性:

属性名类型说明
textstring文本内容

构建文本消息

let message = await engine.createTextMessage(
type,
targetId,
channelId,
text,
);
参数名参数类型描述
typeRCIMIWConversationType会话类型,
targetIdstring会话 ID
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
textstring文本内容

语音消息

类型:RCIMIWMessageType.voice

专有可访问属性:

属性名类型说明
durationnumber语音的长度,单位:秒

构建语音消息

recorderManager.onStop(async function (res) {
//转为平台路径
let path = 'file:///' + plus.io.convertLocalFileSystemURL(res.tempFilePath);
let message = await engine.createVoiceMessage(type, targetId, channelId, path, duration);
})
参数名参数类型描述
typeRCIMIWConversationType会话类型
targetIdstring会话 ID
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
pathstring语音消息的本地路径,必须为有效路径
durationnumber语音消息的消息时长

图片消息

类型:RCIMIWMessageType.image

专有可访问属性:

属性名类型说明
thumbnailBase64Stringstring图片的缩略图数据
originalboolean是否为原图

构建图片消息

uni.chooseImage({
count: 1,
success: async (res) => {
if (res.tempFilePaths.length < 0) return;
//转为平台路径
let path = 'file:///' + plus.io.convertLocalFileSystemURL(res.tempFilePaths[0])
//创建图片消息
let message = await engine.createImageMessage(type, targetId, channelId, path);
}
});
参数名参数类型描述
typeRCIMIWConversationType会话类型
targetIdstring会话 ID
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
pathstring图片消息的本地路径,必须为有效路径

文件消息

类型:RCIMIWMessageType.file

专有可访问属性:

属性名类型说明
namestring文件名
fileTypestring文件类型
sizenumber文件大小,单位为 Byte

构建文件消息

//项目本地路径:前面加www是因为手机存储中生成的项目对应的该文件前面有www文件夹,请根据自身情况使用可找到文件的路径并转为平台路径
const path = 'file://' + plus.io.convertLocalFileSystemURL('../www/static/assets/sendFileMessage.docx');
//创建文件消息
let message = await engine.createFileMessage(type,targetId,channelId,path);
参数名参数类型描述
typeRCIMIWConversationType会话类型
targetIdstring会话 ID
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
pathstring文件消息的本地路径,必须为有效路径

小视频消息

类型:RCIMIWMessageType.sight

专有可访问属性:

属性名类型说明
durationnumber视频时长
sizenumber视频大小
namestring视频的名称
thumbnailBase64Stringstring缩略图数据

构建小视频消息

//选择视频
uni.chooseVideo({
count: 1,
sourceType: ['album', 'camera'],
success: async (res) => {
const duration = parseInt(res.duration);
const path = plus.io.convertLocalFileSystemURL(res.tempFilePath);
//创建消息
let message = await engine.createSightMessage(type, targetId, channelId, path, duration);
//发送消息
let code = await engine.sendMediaMessage(message);
}
});
参数名参数类型描述
typeRCIMIWConversationType会话类型
targetIdstring会话 ID
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
pathstring小视频消息的本地路径,必须为有效路径
durationnumber小视频消息的视频时长

GIF图消息

类型:RCIMIWMessageType.gif

专有可访问属性:

属性名类型说明
dataSizenumberGIF 图的大小,单位字节
widthnumberGIF 图的宽
heightnumberGIF 图的高

构建 GIF 消息

uni.chooseImage({
count: 1,
success: async (res) => {
if (res.tempFilePaths.length < 0) return;
// 转为平台路径
const path = 'file:///' + plus.io.convertLocalFileSystemURL(res.tempFilePaths[0]);
// 创建消息
let message = await engine.createGIFMessage(type, targetId, channelId, path);
}
});
参数名参数类型描述
typeRCIMIWConversationType会话类型
targetIdstring会话 ID
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
pathstringGIF 消息的本地路径

撤回消息

撤回消息不可以主动构建发送,需要撤回消息请调用撤回消息接口

类型:RCIMIWMessageType.recall

专有可访问属性:

属性名类型说明
adminboolean是否是管理员操作
deletedboolean是否删除
recallTimenumber被撤回的原始消息的发送时间(毫秒)
recallActionTimenumber撤回动作的时间(毫秒)
originalMessageRCIMIWMessage被撤回的原消息

引用消息

类型:RCIMIWMessageType.reference

专有可访问属性:

属性名类型说明
textstring引用文本
referenceMessageRCIMIWMessage被引用的消息

构建引用消息

let message = await engine.createReferenceMessage(
type,
targetId,
channelId,
referenceMessage,
text,
);
参数名参数类型描述
typeRCIMIWConversationType会话类型
targetIdstring会话 ID
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
referenceMessageRCIMIWMessage引用的消息
textstring引用的文本内容

位置消息

类型:RCIMIWMessageType.location

专有可访问属性:

属性名类型说明
longitudenumber经度信息
latitudenumber纬度信息
poiNamestringPOI 信息
thumbnailPathstring缩略图地址

构建位置消息

let message = await engine.createLocationMessage(
type,
targetId
channelId,
longitude,
latitude,
poiName,
path, // 缩略图本地平台路径
);
参数名参数类型描述
typeRCIMIWConversationType会话类型
targetIdstring会话 ID
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
longitudenumber经度
latitudenumber纬度
poiNamestringPOI 信息
thumbnailPathstring缩略图本地路径,必须为有效路径

命令消息

类型:RCIMIWMessageType.command

专有可访问属性:

属性名类型说明
namestring命令的名称
datastring命令的扩展数据,可以为任意字符串,如存放您定义的json数据。

命令通知消息

类型:RCIMIWMessageType.commandNotification

专有可访问属性:

属性名类型说明
namestring命令提醒的名称
datastring命令提醒消息的扩展数据,可以为任意字符串,如存放您定义的 json 数据。

自定义消息

类型:RCIMIWMessageType.custom

专有可访问属性:

属性名类型说明
identifierstring自定义消息的标识符
policyRCIMIWCustomMessagePolicy自定义的消息存储策略
fieldsMap<string, string>自定义消息的键值对

构建自定义消息

let message = await engine.createCustomMessage(
type,
targetId,
channelId,
policy,
messageIdentifier,
fields,
);
参数名参数类型描述
typeRCIMIWConversationType会话类型
targetIdstring会话 ID
channelIdstring频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
policyRCIMIWCustomMessagePolicy消息的存储策略
messageIdentifierstring消息的标识符,需唯一
fieldsMap<string, string>消息的内容键值对

无效类型

当接收到无法识别的消息时,会变为无效类型的消息,此消息不可主动构建发送

类型:RCIMIWMessageType.unknown

专有可访问属性:

属性名类型描述
rawDatastring消息数据
objectNamestring消息的标识