聊天室会话 ID
聊天室属性
用户掉线或退出时,是否自动删除该 Key、Value 值
是否强制覆盖
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
设置聊天室自定义属性。
聊天室会话 ID
聊天室属性名称,Key 支持大小写英文字母、数字、部分特殊符号 + = - _ 的组合方式,最大长度 128 个字符
聊天室属性对应的值,最大长度 4096 个字符
用户掉线或退出时,是否自动删除该 Key、Value 值
如果当前 key 存在,是否进行覆盖
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
将某个用户加入黑名单。 当你把对方加入黑名单后,对方再发消息时,就会提示“已被加入黑名单,消息发送失败”。 但你依然可以发消息个对方。
用户 Id
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
取消下载媒体消息
需要取消下载的媒体消息实体
取消下载媒体消息的事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
取消发送媒体消息
需要取消发送的媒体消息实体
取消发送媒体消息的事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
设置会话的消息提醒状态 注:超级群调用该接口,channelId 为空时,相当于设置了 channelId 为空的频道的免打扰,不会屏蔽整个超级群会话下所有频道的免打扰
会话类型。请注意以下限制:
targetId
)中不属于任何频道的消息的免打扰状态级别。如需修改请提交工单。会话 ID
超级群的会话频道 ID。其他类型传 null 即可。
targetId
)中不属于任何频道的消息设置免打扰状态级别。如需修改请提交工单。消息通知级别
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
设置会话的置顶状态。若会话不存在,调用此方法 SDK 自动创建会话并置顶。
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
是否置顶
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
设置会话类型的消息提醒状态 注:如要移除消息提醒状态,设置level为RCIMIWPushNotificationLevelDefault
会话类型
消息通知级别
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
修改日志等级
日志级别
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
设置消息接收状态。
消息的 messageId,可在消息对象中获取
要修改的状态
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
设置消息发送状态。
消息的 messageId,可在消息对象中获取
要修改的状态
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
屏蔽某个时间段的消息提醒
开始消息免打扰时间,格式为 HH:MM:SS
需要消息免打扰分钟数,0 < spanMinutes < 1440( 比如,您设置的起始时间是 00:00, 结束时间为 01:00,则 spanMinutes 为 60 分钟。设置为 1439 代表全天免打扰 (23 60 + 59 = 1439 ))
消息通知级别
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
设置是否显示远程推送内容详情,此功能需要从服务端开启用户设置功能。
是否显示远程推送内容
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
设置推送语言
推送语言, 目前仅支持 en_us、zh_cn、ar_sa
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
设置是否接收远程推送。 前提:移动端未在线,Web 、MAC/PC 终端在线,移动端是否接收远程推送。 此功能需要从服务端开启用户设置功能。
是否接收
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
设置超级群频道的默认消息状态
会话 ID
频道 ID,仅支持超级群使用。
消息通知级别
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
设置超级群的默认消息状态 一般由管理员设置的接口,针对超级群的所有群成员生效,针对超级群下所有频道生效,优先级较低。如果群成员自己超级群的免打扰级别,那么以群成员自己设置的为准。
会话 ID
消息通知级别
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
删除指定会话中的草稿信息。
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
清除消息
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
清除消息截止时间戳,0 <= recordTime <= 当前会话最后一条消息的 sentTime, 0 清除所有消息,其他值清除小于等于 recordTime 的消息
清除的策略
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
删除超级群指定时间之前的消息
会话 ID
频道 ID,仅支持超级群使用。
时间戳
清除策略
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
删除超级群所有频道指定时间之前的消息
会话 ID
时间戳
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
清除某个会话中的未读消息数。 注:不支持聊天室!
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
该会话已阅读的最后一条消息的发送时间戳,清除所有传入当前最新时间戳
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
连接融云服务器,在整个应用程序全局,只需要调用一次。调用此接口返回非业务错误码时,SDK 会启动重连机制进行重连;如果仍没有连接成功,会在设备网络状态变化时再次进行重连。
调用 server api 获取到的 token
连接超时时间,单位:秒。 timeLimit <= 0,则 IM 将一直连接,直到连接成功或者无法连接(如 token 非法) timeLimit > 0,则 IM 将最多连接 timeLimit 秒 如果在 timeLimit 秒内连接成功,后面再发生了网络变化或前后台切换,SDK 会自动重连; 如果在 timeLimit 秒无法连接成功则不再进行重连,通过 listener 告知连接超时,您需要再自行调用 connect 接口
链接事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
构建自定义消息
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
消息的存储策略
消息的标识符,需唯一
消息的内容键值对
自定义消息实体
构建文件消息
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
文件消息的本地路径,必须为有效路径
文件消息实体
构建 GIF 消息
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
GIF 消息的本地路径
GIF 消息实体
构建图片消息
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
图片消息的本地路径,必须为有效路径
图片消息实体
构建位置消息
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
经度
纬度
POI 信息
缩略图本地路径,必须为有效路径
位置消息实体
构建引用消息
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
引用的消息
引用的文本内容
引用消息实体
构建小视频消息
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
小视频消息的本地路径,必须为有效路径
小视频消息的视频时长
视频消息实体
构建文本消息
会话类型,
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
文本内容
文本消息实体
构建语音消息 (高清语音)
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
语音消息的本地路径,必须为有效路径
语音消息的消息时长
语音消息的实体
删除本地消息
消息集合
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
删除消息
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
消息集合
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
销毁 IM 对象
断开链接 注:因为 SDK 在前后台切换或者网络出现异常都会自动重连,保证连接可靠性。 所以除非您的 App 逻辑需要登出,否则一般不需要调用此方法进行手动断开
退出后是否接收 push,true:断开后接收远程推送,false:断开后不再接收远程推送
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
下载媒体消息
需要下载的媒体消息实体
下载媒体消息的事件监听
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
从服务获取批量消息
获取的消息集合
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取当前用户设置的黑名单列表。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取某用户是否在黑名单中。
用户 Id
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取免打扰的会话列表。
会话类型集合
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取聊天室所有属性。
聊天室会话 ID
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取聊天室单个属性。
聊天室会话 ID
聊天室属性键值
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取聊天室历史消息记录。 注:必须先开通聊天室消息云存储功能。
聊天室会话 ID
起始的消息发送时间戳
拉取顺序 0:倒序,1:正序
要获取的消息数量,0 < count <= 50。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取某个会话
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可
获取会话事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取会话的消息提醒状态
会话类型。请注意以下限制:
targetId
)中不属于任何频道的消息的免打扰状态级别。如需修改请提交工单。会话 ID
超级群的会话频道 ID。其他类型传 null 即可。
targetId
)中不属于任何频道的消息设置免打扰状态级别。如需修改请提交工单。事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取会话的置顶状态
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取会话类型的消息提醒状态
会话类型
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
获取某些会话
会话类型
频道 ID,仅支持超级群使用,其他会话类型传 null 即可
时间戳(毫秒),获取小于此时间戳的会话,传 0 为查询最新数据
查询的数量, 0 < count <= 50
获取会话列表事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取特定会话下所有频道的会话列表,只支持超级群
会话类型
会话 ID
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取本地时间与服务器时间的时间差。消息发送成功后,SDK 与服务器同步时间,消息所在数据库中存储的时间就是服务器时间。 System.currentTimeMillis() - getDeltaTime() 可以获取服务器当前时间。
本地时间与服务器时间的差值
获取会话中的草稿信息。
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取第一条未读消息。
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
根据消息 id 获取消息体(本地数据库索引唯一值)。
消息的 messageId,可在消息对象中获取
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
通过全局唯一 id 获取消息实体。
消息的 messageUid,可在消息对象中获取,且只有发送成功的消息才会有值。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取指定会话的消息总数。
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载历史消息
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
当前消息时间戳
获取消息的方向。BEFORE:获取 sentTime 之前的消息 (时间递减),AFTER:获取 sentTime 之后的消息 (时间递增)
消息的加载策略。LOCAL:只加载本地,REMOTE:只加载远端,LOCAL_REMOTE:本地远端都加载
获取的消息数量,0 < count <= 20
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取已设置的时间段消息提醒屏蔽
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
根据会话类型,获取置顶会话列表
会话类型集合
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取所有未读数
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
获取所有未读数事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取当前用户加入的所有超级群会话的未读消息数的总和。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取当前用户加入的所有超级群会话中的未读 @ 消息数的总和。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取超级群频道的默认消息状态
会话 ID
频道 ID,仅支持超级群使用。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取超级群的默认消息状态
会话 ID
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取指定会话的未读消息数
会话 ID
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取超级群会话中被 @ 的消息数
会话 ID
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取某个会话的未读数 注:不支持聊天室!
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
获取会话未读数事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
根据会话类型加载未读数 注:不支持聊天室!
会话类型集合
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
是否包含免打扰消息的未读消息数。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取会话中未读的 @ 消息数量。 注:不支持聊天室!
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
获取会话中未读的 @ 消息数量事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取会话中未读的 @ 消息。
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
插入一条消息
插入的消息
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
插入多条消息,不支持超级群
插入的消息集合
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加入聊天室。
聊天室会话 ID
进入聊天室拉取消息数目,-1 时不拉取任何消息,0 时拉取 10 条消息,最多只能拉取 50
是否创建聊天室,TRUE 如果聊天室不存在,sdk 会创建聊天室并加入,如果已存在,则直接加入
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
退出聊天室。
聊天室会话 ID
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
从服务获取批量消息
获取的消息集合
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载当前用户设置的黑名单列表。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取某用户是否在黑名单中。
用户 Id
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载免打扰的会话列表。
会话类型集合
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载聊天室所有属性。
聊天室会话 ID
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载聊天室单个属性。
聊天室会话 ID
聊天室属性键值
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载聊天室历史消息记录。 注:必须先开通聊天室消息云存储功能。
聊天室会话 ID
起始的消息发送时间戳
拉取顺序 0:倒序,1:正序
要获取的消息数量,0 < count <= 50。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载某个会话
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载会话的消息提醒状态
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载会话的置顶状态
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取会话类型的消息提醒状态
会话类型
加载某些会话
会话类型
频道 ID,仅支持超级群使用,其他会话类型传 null 即可
时间戳(毫秒),获取小于此时间戳的会话,传 0 为查询最新数据
查询的数量, 0 < count <= 50
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取特定会话下所有频道的会话列表,只支持超级群
会话类型
会话 ID
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载会话中的草稿信息。
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载第一条未读消息。
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载指定会话的消息总数。
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载历史消息
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
当前消息时间戳
获取消息的方向。BEFORE:获取 sentTime 之前的消息 (时间递减),AFTER:获取 sentTime 之后的消息 (时间递增)
消息的加载策略。LOCAL:只加载本地,REMOTE:只加载远端,LOCAL_REMOTE:本地远端都加载
获取的消息数量,0 < count <= 20
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载已设置的时间段消息提醒屏蔽
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
根据会话类型,加载置顶会话列表
会话类型集合
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载所有未读数
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载当前用户加入的所有超级群会话的未读消息数的总和。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载当前用户加入的所有超级群会话中的未读 @ 消息数的总和。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取超级群频道的默认消息状态
会话 ID
频道 ID,仅支持超级群使用。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取超级群的默认消息状态
会话 ID
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取指定会话的未读消息数
会话 ID
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
获取超级群会话中被 @ 的消息数
会话 ID
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载某个会话的未读数 注:不支持聊天室!
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
根据会话类型加载未读数 注:不支持聊天室!
会话类型集合
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
是否包含免打扰消息的未读消息数。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载会话中未读的 @ 消息数量。 注:不支持聊天室!
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
加载会话中未读的 @ 消息。
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
修改超级群消息
消息的 messageUid,可在消息对象中获取,且只有发送成功的消息才会有值
要修改的 message
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
撤回消息
需要被撤回的消息
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
撤回超级群消息
需要撤回的消息
是否删除远端消息
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
注册推送 token 给融云,用于不集成融云推送 SDK 但需使用融云消息推送能力。 如果是 iOS 平台时,会忽略传入的 pushType 值,只使用 pushToken 参数。 该方法需要在 IM 初始化后 3 秒再调用。
推送厂商类型
推送 token (厂商接口 或 三方推送 SDK 提供的)
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
批量删除聊天室自定义属性
聊天室会话 ID
聊天室属性
是否强制覆盖
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
删除聊天室自定义属性。
聊天室会话 ID
聊天室属性键值
是否强制删除
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
移除某个会话
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可
移除会话事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
根据会话类型移除会话
会话类型集合
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
移除会话列表事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
将某个用户从黑名单中移出。
用户 Id
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
删除消息扩展信息中特定的键值对
消息的 messageUid,可在消息对象中获取,且只有发送成功的消息才会有值
消息扩展信息中待删除的 key 的列表,类型是 ArrayList
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
删除已设置的全局时间段消息提醒屏蔽
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
删除超级群消息扩展信息中特定的键值对
消息的 messageUid,可在消息对象中获取,且只有发送成功的消息才会有值
消息扩展信息中待删除的 key 的列表,类型是 ArrayList
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
保存会话草稿信息。
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
草稿的文字内容。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
根据关键字搜索会话。
会话类型集合
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
搜索的消息类型
搜索的关键字。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
根据关键字搜索指定会话中的消息。
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
搜索的关键字
查询 beginTime 之前的消息, 传 0 时从最新消息开始搜索,从该时间往前搜索。
查询的数量,0 < count <= 50。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
根据关键字搜索指定会话中某个时间段的消息。
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
搜索的关键字
开始时间
结束时间
偏移量
返回的搜索结果数量,0 < count <= 50。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
根据用户 id 搜索指定会话中的消息。
用户 id
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
查询记录的起始时间, 传 0 时从最新消息开始搜索,从该时间往前搜索。
返回的搜索结果数量 0 < count <= 50。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
给指定的群成员发送消息
要发送的消息
群成员集合
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
发起群聊消息已读回执请求
需要请求已读回执的消息
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
发送群聊已读回执
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
会话中需要发送已读回执的消息列表
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
发送媒体消息
发送的媒体消息实体
发送媒体消息的事件监听
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
发送普通消息
发送的消息实体
发送消息的事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
发送某个会话中的消息阅读回执
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
该会话中已读的最后一条消息的发送时间戳
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
向会话中发送正在输入的状态,目前只支持单聊。
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
当前的状态
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
发送超级群输入状态
会话 ID
频道 ID,仅支持超级群使用。
输入状态
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
[loadBatchRemoteUltraGroupMessages] 的接口监听
[addToBlacklist] 的接口监听
[loadBlacklist] 的接口监听
[removeFromBlacklist] 的接口监听
[loadBlacklistStatus] 的接口监听
[loadBlockedConversations] 的接口监听
[loadChatRoomAllEntries] 的接口监听
[addChatRoomEntries] 的接口监听
聊天室 KV 发生变化的回调
[removeChatRoomEntries] 的接口监听
聊天室 KV 同步完成的回调
[addChatRoomEntry] 的接口监听
[loadChatRoomEntry] 的接口监听
[removeChatRoomEntry] 的接口监听
[joinChatRoom] 的接口监听
正在加入聊天室的回调
[leaveChatRoom] 的接口监听
聊天室用户进入、退出聊天室监听
[loadChatRoomMessages] 的接口监听
聊天室状态发生变化的监听
[connect] 的接口监听,收到链接结果的回调
网络状态变化
[loadConversation] 的接口监听
[changeConversationNotificationLevel] 的接口回调
[loadConversationNotificationLevel] 的接口回调
会话状态免打扰多端同步监听
同步消息未读状态监听接口。多端登录,收到其它端清除某一会话未读数通知的时候
[syncConversationReadStatus] 的接口监听
[removeConversation] 的接口监听
[changeConversationTopStatus] 的接口监听
[loadConversationTopStatus] 的接口监听
会话状态置顶多端同步监听
[changeConversationTypeNotificationLevel] 的接口回调
[loadConversationTypeNotificationLevel] 的接口回调
[loadConversationsForAllChannel] 的接口监听
[loadConversations] 的接口监听
[removeConversations] 的接口监听
[searchConversations] 的接口监听
[connect] 的接口监听,数据库打开时发生的回调
[cancelDownloadingMediaMessage] 的接口监听
[clearDraftMessage] 的接口监听
[loadDraftMessage] 的接口监听
[saveDraftMessage] 的接口监听
[loadFirstUnreadMessage] 的接口监听
收到群聊已读回执请求的监听
收到群聊已读回执响应的监听
[sendGroupMessageToDesignatedUsers] 的接口回调 消息存入数据库的回调
[sendGroupMessageToDesignatedUsers] 的接口回调 消息发送完成的回调
sendGroupReadReceiptRequest 的接口监听
[sendGroupReadReceiptResponse] 的接口监听
[deleteLocalMessages] 的接口监听
[sendMediaMessage] 的接口监听
[downloadMediaMessage] 的接口监听
[downloadMediaMessage] 的接口监听
[sendMediaMessage] 的接口监听
[sendMediaMessage] 的接口监听
[sendMessage] 的接口监听
发送含有敏感词消息被拦截的回调
[loadMessageCount] 的接口监听
[removeMessageExpansionForKeys] 的接口监听
[updateMessageExpansion] 的接口监听
[insertMessage] 的接口监听
[recallMessage] 的接口监听
[changeMessageReceiveStatus] 的接口监听
收到消息的监听
[sendMessage] 的接口监听
[changeMessageSentStatus] 的接口监听
[clearMessages] 的接口监听
[deleteMessages] 的接口监听
[insertMessages] 的接口监听
[loadMessages] 的接口监听
[searchMessagesByTimeRange] 的接口监听
[searchMessagesByUserId] 的接口监听
[searchMessages] 的接口监听
[changeNotificationQuietHours] 的接口回调
[loadNotificationQuietHours] 的接口回调
[removeNotificationQuietHours] 的接口回调
[sendPrivateReadReceiptMessage] 的接口监听
单聊中收到消息回执的回调。
[changePushContentShowStatus] 的接口监听
[changePushLanguage] 的接口监听
[changePushReceiveStatus] 的接口监听
消息扩展信息删除的回调
消息扩展信息更改的回调
撤回消息监听器
超级群消息 kv 被更新
超级群消息被更改
超级群消息被撤回
[cancelSendingMediaMessage] 的接口监听
[loadTotalUnreadCount] 的接口监听
会话输入状态发生变化。对于单聊而言,当对方正在输入时,监听会触发一次;当对方不处于输入状态时,该监听还会触发一次,但回调里输入用户列表为空。
[loadUltraGroupAllUnreadMentionedCount] 的接口监听
[loadUltraGroupAllUnreadMentionedCount] 的接口监听
[changeUltraGroupChannelDefaultNotificationLevel] 的接口回调
[loadUltraGroupChannelDefaultNotificationLevel] 的接口回调
超级群列表同步完成的回调
[changeUltraGroupDefaultNotificationLevel] 的接口回调
[loadUltraGroupDefaultNotificationLevel] 的接口回调
[removeUltraGroupMessageExpansionForKeys] 的接口监听
[updateUltraGroupMessageExpansion] 的接口监听
[modifyUltraGroupMessage] 的接口监听
[recallUltraGroupMessage] 的接口监听
[clearUltraGroupMessagesForAllChannel] 的接口监听
[clearUltraGroupMessages] 的接口监听
[syncUltraGroupReadStatus] 的接口监听
超级群已读的监听
用户输入状态变化的回调 当客户端收到用户输入状态的变化时,会回调此接口,通知发生变化的会话以及当前正在输入的RCUltraGroupTypingStatusInfo列表
[sendUltraGroupTypingStatus] 的接口监听
[loadUltraGroupUnreadMentionedCount] 的接口监听
[loadUnreadCountByConversationTypes] 的接口监听
[clearUnreadCount] 的接口监听
[loadUnreadCount] 的接口监听
[loadUnreadMentionedCount] 的接口监听
[loadUnreadMentionedMessages] 的接口监听
同步会话阅读状态。
会话类型
会话 ID
频道 ID,仅支持超级群使用,其他会话类型传 null 即可。
会话中已读的最后一条消息的发送时间戳
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
上报超级群的已读时间
会话 ID
频道 ID,仅支持超级群使用。
已读时间
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
更新消息扩展信息 每条消息携带扩展信息键值对最大值 300个,单次设置扩展信息键值对最大值 20个
消息的 messageUid,可在消息对象中获取,且只有发送成功的消息才会有值
要更新的消息扩展信息键值对,类型是 HashMap;Key 支持大小写英文字母、数字、部分特殊符号 + = - _ 的组合方式,不支持汉字。Value 可以输入空格
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
更新超级群消息扩展信息
消息的 messageUid,可在消息对象中获取,且只有发送成功的消息才会有值
更新的消息扩展信息键值对,类型是 HashMap;Key 支持大小写英文字母、数字、部分特殊符号 + = - _ 的组合方式,不支持汉字。Value 可以输入空格。
事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。
当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码
初始化 IM 对象
融云后台申请的应用 appKey
全局配置项
创建的 IM 对象
Generated using TypeDoc
批量设置聊天室自定义属性
[onChatRoomEntriesAdded]