IM即时通讯

类型定义

WsResponse

通用回调参数

参数 类型 说明
errCode number 调用失败时的错误码
errMsg string 调用失败时的错误描述信息
data T 调用成功时的返回结果,作为泛型
operationID string 调用时传入的 operationID

CRIMAssetsConfig

SDK 静态资源依赖路径配置

参数 类型 说明
sdkWasm string SDK包内WASM路径,可配置为CDN
sqlWasm string sql.js的WASM路径,可配置为CDN

CRIMPublicUserItem

用户公开信息,主要是基本信息,不包括手机等其它隐私字段

参数 类型 说明
userID string 用户ID
nickname string 用户昵称
faceURL string 头像URL
ex string 扩展属性

CRIMFriendUserItem

好友用户基本信息。

参数 类型 说明
userID string 用户ID
nickname string 用户昵称
faceURL string 头像URL
ownerUserID string 本人的userID
remark string 好友备注
createTime number 成为好友的时间
addSource number 成为好友的方式
operatorUserID string 使双方成为好友的uesrID
attachedInfo string 暂未实现
ex string 应用层扩展内容

CRIMSearchedFriendsInfo

参数 类型 说明
userID string 用户ID
nickname string 用户昵称
faceURL string 头像URL
ownerUserID string 本人的userID
remark string 好友备注
createTime number 成为好友的时间
addSource number 成为好友的方式
operatorUserID string 使双方成为好友的uesrID
phoneNumber string 手机号码
birth string 生日
email string 邮箱
attachedInfo string 暂未实现
ex string 应用层扩展内容
relationship number 0黑名成员,1是好友

CRIMBlackInfo

黑名单信息,黑名单用户基本信息,注意黑名单是双向关系。

参数 类型 说明
userID string 用户ID
nickname string 用户昵称
faceURL string 头像URL
createTime number 拉黑时间
addSource number 拉黑方式
operatorUserID string 操作拉黑的uesrID
ex string 应用层扩展内容

CRIMSelfUserInfo

参数 类型 说明
userID string 用户ID
nickname string 用户昵称
faceURL string 用户头像
createTime number 用户注册时间
ex string 用户扩展字段
globalRecvMsgOpt MessageReceiveOptType 全局消息接收设置

CRIMUserOnlineState

参数 类型 说明
userID string 用户ID
platformIDs Platform[] 登录的平台
status number 0 表示离线,1 表示在线

CRIMConversationItem

会话信息

参数 类型 说明
conversationID string 会话ID
conversationType CRIMConversationType 会话类型
userID string 用户ID
groupID string 群组ID
showName string 会话显示的名称
faceURL string 头像URL
recvMsgOpt CRIMReceiveMessageOpt 消息接收方式
unreadCount number 未读数
groupAtType CRIMGroupAtType @类型
latestMsgSendTime number 最近消息的发送时间
draftText string 草稿内容
draftTextTime number 生成草稿的时间
isPinned boolean 是否为置顶状态
isPrivateChat boolean 是否开启了阅后即焚
burnDuration number 阅后即焚的时长
isNotInGroup boolean 是否还在组内,true: 已不在群内
attachedInfo string 附加信息
latestMsg CRIMMessageInfo 最近的一条消息
ex string 应用层扩展内容

CRIMMessageInfo

消息结构体

参数 类型 说明
clientMsgID string 客户端消息ID
serverMsgID string 服务端消息ID
createTime number 创建消息的时间
sendTime number 发送消息的时间
sessionType CRIMConversationType 会话类型
sendID string 发送消息者ID
recvID string 接收消息者ID
msgFrom CRIMMessageLevel 消息来源级别
contentType CRIMMessageContentType 消息类型
senderPlatformID Platform 平台ID
senderNickname string 发送者昵称
senderFaceUrl string 发送者头像URL
groupID string 群组ID
content string 消息内容
seq number 消息的seq
isRead string 已读标识
status CRIMMessageStatus 消息发送的状态
attachedInfo string 附加信息
ex string 扩展信息
offlinePush CRIMOfflinePushInfo 离线消息推送内容
textElem CRIMTextElem 文本内容
cardElem CRIMCardElem 名片内容
pictureElem CRIMPictureElem 图片消息内容
soundElem CRIMSoundElem 语音消息内容
videoElem CRIMVideoElem 视频 消息内容
fileElem CRIMFileElem 文件消息内容
mergeElem CRIMMergeElem 合并消息内容
atTextElem CRIMAtTextElem @消息内容
locationElem CRIMLocationElem 地理位置内容
quoteElem CRIMQuoteElem 引用消息内容
customElem CRIMCustomElem 自定义消息内容
notificationElem string 通知消息内容
faceElem CRIMFaceElem 自定义表情内容
attachedInfoElem CRIMAttachedInfoElem 附加消息内容
typingElem CRIMTypingElem 正在输入消息内容
hasReadTime number 已读的时间

CRIMTextElem

文本消息内容

参数 类型 说明
content string 文本内容

CRIMCardElem

卡片消息内容

参数 类型 说明
userID string 用户ID
nickname string 用户昵称
faceURL string 头像URL
ex string 应用层扩展内容

CRIMSoundElem

语音消息内容

参数 类型 说明
uuID string 唯一ID
soundPath string 本地路径
sourceUrl string 音频文件URL
dataSize number 音频文件大小
duration number 音频文件时长

CRIMPictureElem

图片消息内容

参数 类型 说明
sourcePath string 本地路径
sourcePicture CRIMPictureInfo 本地图片详情
bigPicture CRIMPictureInfo 大图详情
snapshotPicture CRIMPictureInfo 缩略图详情

CRIMVideoElem

参数 类型 说明
videoPath string 视频本地路径
videoUUID string 视频ID
videoUrl string 视频URL
videoType string 视频类型
videoSize number 视频大小
duration number 视频时长
snapshotPath string 视频快照本地路径
snapshotUUID string 视频快照ID
snapshotSize number 视频快照大小
snapshotUrl string 视频快照URL
snapshotWidth number 视频快照宽度
snapshotHeight number 视频快照高度

CRIMFileElem

文件消息内容

参数 类型 说明
filePath string 文件本地路径
uuID string 唯一ID,可为空
sourceUrl string 图片地址
fileName string 文件名称
fileSize number 文件大小

CRIMPictureInfo

图片信息描述

参数 类型 说明
uuID string 唯一ID,可为空
type string 图片类型, 可为空
size number 图片大小
width number 图片宽度
height number 图片高度
url string 图片URL地址

CRIMMergeElem

合并消息内容

参数 类型 说明
title string 标题
abstractList string[] 需要显示的前几条消息的摘要
multiMessage CRIMMessageInfo[] 选择合并的消息内容列表

CRIMAtTextElem

at文本元素

参数 类型 说明
text string 消息内容
atUserList string[] 被@的用户ID列表
atUsersInfo CRIMAtInfo[] 被@的用户信息列表
quoteMessage CRIMMessageInfo 引用的消息内容
isAtSelf string @的是否是自己
isAtAll string 是否@全体成员

CRIMLocationElem

定位消息内容

参数 类型 说明
desc string 位置描述内容
longitude number 经度
latitude number 纬度

CRIMQuoteElem

引用消息内容

参数 类型 说明
text string 回复的消息内容
quoteMessage CRIMMessageInfo 被引用的消息

CRIMCustomElem

自定义消息内容

参数 类型 说明
data string 文本内容
extension string 扩展内容
description string 描述信息

CRIMFaceElem

表情消息

参数 类型 说明
index string 表情的下标位置,发送端对接收端自定义内嵌的表情包
data string 其他表情,如URL表情直接返回URL

CRIMAttachedInfoElem

附加消息内容

参数 类型 说明
groupHasReadInfo CRIMGroupHasReadInfo 已读消息的群成员信息
isPrivateChat boolean 是否为私聊
burnDuration number 阅后即焚时间
hasReadTime number 已读的时间点
notSenderNotificationPush boolean 不发推送消息
isEncryption boolean 是否加密
inEncryptStatus boolean 当前加密状态
uploadProgress CRIMUploadProgress 上传进度

CRIMUploadProgress

上传进度

参数 类型 说明
total number 上传总大小
save number 已存储大小
current number 当前上传大小

CRIMGroupHasReadInfo

群消息已读用户

参数 类型 说明
hasReadUserIDList string[] 已读的用户ID列表
hasReadCount number 已读总数
groupMemberCount number 当时发送此条消息的群人数

CRIMAdvancedTextElem

高级消息内容

参数 类型 说明
text string 消息内容

CRIMTypingElem

提示消息内容

参数 类型 说明
msgTips string 提示的内容

CRIMFriendReq

好友申请信息

参数 类型 说明
fromUserID string 发起者userID
fromNickname string 发起者昵称
fromFaceURL string 发起者头像URL
toUserID string 被添加者userID
toNickname string 被添加者昵称
toFaceURL string 被添加者头像URL
handleResult CRIMApplicationStatus 申请的处理结果
reqMsg string 申请添加好友时的申请内容
createTime number 发起申请的时间
handlerUserID string 处理人的userID
handleMsg string 处理好友申请时的审批消息
handleTime number 处理时间
ex string 应用层扩展内容

CRIMSimpleResultInfo

参数 类型 说明
userID string 被添加者userID
result number 1是好友 0非好友

CRIMSearchFriendsParam

查询好友使用,isSearchNickname,isSearchRemark不可以同时为false

参数 类型 说明
keywordList string[] 关键词列表,目前仅支持单个关键词
isSearchUserID boolean 是否以关键词搜索userID
isSearchNickname boolean 是否以关键词搜索昵称,默认false
isSearchRemark boolean 是否以关键词搜索备注,默认false

CRIMGroupInfo

群组信息

参数 类型 说明
groupID string 群组ID
groupName string 群名称
introduction string 群简介
faceURL string 群头像URL
createTime number 群创建的时间
memberCount number 群成员数量
status CRIMGroupStatus 群状态
creatorUserID string 创建者userID
ownerUserID string 所有者userID
needVerification CRIMGroupVerificationType 进群验证方式
lookMemberInfo CRIMAllowType 是否允许查看其他群成员的信息
applyMemberFriend CRIMAllowType 是否可以添加群成员为好友
notification string 群公告
notificationUpdateTime number 群公告更新的时间
notificationUserID string 群公告发布者userID
ex string 应用层扩展内容

CRIMGroupMemberInfo

群成员信息

参数 类型 说明
userID string 群成员ID
roleLevel CRIMGroupMemberRole 群成员身份
groupID string 群组ID
nickname string 群成员昵称
faceURL string 群成员头像URL
joinTime number 群成员进群的时间
joinSource CRIMJoinType 群成员进群方式
operatorUserID string 同意进群的userID
muteEndTime number 禁言结束时间
inviterUserID string 邀请者userID
ex string 应用层扩展内容

CRIMGroupReqInfo

申请入群信息

参数 类型 说明
groupID string 群组ID
groupName string 群名称
notification string 群公告
introduction string 群简介
groupFaceURL string 群头像URL
createTime number 申请入群的时间
status number 群状态,0:正常 1:禁止聊天 2:已解散 3: 禁言状态
creatorUserID string 建群人userID
ownerUserID string 群主userID
memberCount number 群成员数量
userID string 进群申请者userID
nickname string 进群申请者昵称
userFaceURL string 进群申请者头像URL
handleResult CRIMApplicationStatus 处理结果
reqMsg string 申请加群的申请内容
handledMsg string 处理申请的审批内容
reqTime number 申请进群的时间
handleUserID string 处理进群的userID
handledTime number 处理近期申请的时间
ex string 应用层扩展内容
inviterUserID string 邀请进群userID
joinSource CRIMJoinType 进群方式

CRIMAtInfo

at成员信息

参数 类型 说明
atUserID string at成员的ID
groupNickname string at成员的群昵称

CRIMPicBaseInfo

at成员信息

参数 类型 说明
uuid string 资源唯一ID
type string 文件类型
size number 文件大小
width number 图像宽度
height number 图像高度
url string 图像地址,创建图片消息时可不传

CRIMOfflinePushInfo

离线推送消息内容

参数 类型 说明
title string 推送标题
desc string 推送描述
iOSPushSound string 推送铃声文件的名称
iOSBadgeCount boolean 是否展示角标
operatorUserID string 发送者用户ID
ex string 应用层扩展内容

CRIMSearchResultInfo

查找本地消息结果

参数 类型 说明
totalCount number 总消息数量
searchResultItems CRIMSearchResultItemInfo[] 搜索结果列表

CRIMSearchResultItemInfo

查找本地消息结果的item

参数 类型 说明
conversationID string 会话ID
messageCount number 消息数量
conversationType CRIMConversationType 会话类型
showName string 展示的昵称
faceURL string 头像URL
messageList CRIMMessageInfo[] 消息列表

CRIMGetAdvancedHistoryMessageListInfo

查找历史消息的返回结果

参数 类型 说明
isEnd boolean 是否查询完
lastMinSeq number 上一次拉取回调给的值
errCode number 错误码
errMsg string 错误信息
messageList CRIMMessageInfo[] 消息列表

CRIMReceiptInfo

消息回执

参数 类型 说明
userID string 已读用户ID,仅单聊时有效
groupID string 已读群聊ID,仅群聊时有效
msgIDList string[] 已读消息ID列表
readTime string 接收者阅读消息的时间点
msgFrom CRIMMessageLevel 消息来源
contentType CRIMMessageContentType 消息类型
sessionType CRIMConversationType 会话类型

CRIMMessageRevokedInfo

撤回信息

参数 类型 说明
revokerID string 撤回者的用户ID
revokerNickname string 撤回者昵称
revokerRole CRIMGroupMemberRole 群消息撤回者的身份
clientMsgID string 客户端消息ID
revokeTime number 撤回的时间
sourceMessageSendTime number 消息发送的时间
sourceMessageSendID string 消息发送者userID
sourceMessageSenderNickname string 消息发送者昵称
sessionType CRIMConversationType 会话类型
ex string 应用层扩展信息