发送会话的已读回执。
该方法会通知服务器将此会话未读数设置为 0,消息发送方将会收到 ConversationListener#onConversationRead 回调。
在多端多设备登录下,接收方的其他设备也会收到该回调。
会话 ID。
发送群消息已读回执。
要发送已读回执的群消息。
扩展信息。用户通过定义关键字指定动作或命令。
设置了 ChatOptions.setRequireReadAck 和 ChatMessage.setIsNeedGroupAck 后才能调用该方法。
发送消息的已读回执。
该方法仅适用于单聊会话,仅在 ChatOptions#setRequireReadAck 为 true
时生效。
发送群消息已读回执,详见 ackGroupMessageRead。
推荐进入聊天页面时调用 ackConversationRead ,其他情况下调用该方法以减少调用频率。
已读回执的接收人的用户 ID。
已读回执的消息 ID。
注册会话监听器。
在不需要会话监听器时,可调用 removeConversationListener 方法将其移除。
要注册的会话监听。
标记会话。
调用该方法会同时为本地和服务器端的会话添加标记。
会话 ID 列表。
要添加的会话标记。
要注册的消息监听。
删除服务端的指定会话及其历史消息。
会话 ID。
会话类型。
删除服务端会话及其历史消息成功与否的回调。
true
:是;false
: 否。下载并解析合并消息的附件。
对于一条合并消息,首次调用该方法会下载和解析合并消息附件,然后返回消息列表,而后续调用会存在以下情况:
要下载和解析的合并消息。
下载消息的附件。
监听下载状态,调用 ChatMessage#setMessageStatusCallback。
要下载附件的消息对象。
下载消息的缩略图。
监听下载状态,调用 ChatMessage#setMessageStatusCallback。
要下载缩略图的消息对象。
分页从服务器获取获取会话列表。
SDK 按照会话活跃时间(会话的最后一条消息的时间戳)倒序返回会话列表。
若会话中没有消息,则 SDK 按照会话创建时间的倒序返回会话列表。
每页返回的会话数量。取值范围为 [1,50]。
开始获取数据的游标位置。若获取数据时传空字符串(""),SDK 从最新活跃的会话开始获取。
根据会话过滤类从服务器分页查询会话列表。
会话查询选项,包括会话标记和每页获取的会话条数。
从服务器分页获取群组消息已读回执详情。
发送群组消息回执,可调用 ackGroupMessageRead。
消息 ID。
每页获取的群消息已读回执数。取值范围为 [1,50]。
查询起始的已读回执 ID。 该参数设置后,SDK 从指定的已读回执 ID 开始,按服务器接收已读回执的时间的逆序获取。 若该参数为空,SDK 从最新的已读回执开始按服务器接收回执时间的逆序获取。
根据消息拉取参数配置类 FetchMessageOption 从服务器分页获取指定会话的历史消息。
会话 ID。
会话类型。
每页获取的消息条数。取值范围为 [1,50]。
查询的起始游标位置。
查询历史消息的参数配置类。
分页从服务器获取置顶会话。
SDK 按照会话置顶时间倒序返回。
每页返回的会话数。取值范围为 [1,50]。
开始获取数据的游标位置。若获取数据时传空字符串(""),SDK 从最新置顶的会话开始查询。
从服务端获取置顶消息。
会话 ID。
获取 Reaction 详细信息。
方法参数类。
获取 Reaction 列表。
消息 ID。
会话类型,仅支持单聊( ChatType.Chat )和群聊( ChatType.GroupChat )。
Optional
groupId: string群组 ID,该参数只对群聊生效。
userIds
为概要数据,只包含前三个用户信息。获取本地当前所有会话并排序。
SDK 按照最近一条消息的时间戳的倒序返回会话,置顶会话在前,非置顶会话在后。
根据会话 ID 以及会话类型获取会话。
会话 ID。
会话类型。
未找到指定会话时是否创建一个新会话。
true
:是;false
:否。获取本地当前所有会话。
获取指定 ID 的消息对象。
消息 ID。
将消息导入本地数据库。
你只能将你发送或接收的消息导入本地数据库。
需要导入数据库的消息列表。
修改消息内容。
调用该方法修改消息内容后,本地和服务端的消息均会修改。
调用该方法只能修改单聊和群聊中的文本消息,不能修改聊天室消息。
多设备和该消息的接收方可通过 ChatMessageListener#onMessageContentChanged 回调监听消息是否有变更。
消息 ID。
内容修改后的消息体。
撤回发送成功的消息。
要撤回的消息对象。
扩展信息。
移除会话监听器。
调用 addConversationListener 添加会话监听后再调用本方法移除。
要移除的监听器。
取消标记会话。
调用该方法会同时为本地和服务器端的会话添加标记。
会话 ID 列表。
要移除的会话标记。
移除消息监听器。
调用 addMessageListener 添加消息监听后再调用本方法移除。
要移除的监听器。
单向删除漫游消息(根据消息 ID 删除)。
会话 ID。
会话类型。
要从服务器单向删除的消息 ID 列表。
单向删除漫游消息(根据时间删除)。
会话 ID。
会话类型。
消息删除开始的 UNIX 时间戳,单位为毫秒。设置开始时间后,该方法删除服务器在该时间点之前接收到的消息。
保存消息到本地数据库。
命令消息(类型见:ContentType.CMD,消息体见:CmdMessageBody)不会在本地保存。
待存储的消息。
从本地数据库获取指定会话中包含特定关键字的消息。
查询关键字。
查询的起始消息 Unix 时间戳,单位为毫秒。该参数设置后,SDK 从指定时间戳的消息开始,按消息搜索方向获取。 如果该参数设置为负数,SDK 从当前时间开始搜索。
每次获取的最大消息数。取值范围为 [1,400]。
Optional
from: string单聊或群聊中的消息发送方的用户 ID。若设置为空字符串,SDK 将在整个会话中搜索消息。
Optional
direction: SearchDirection消息搜索方向。详见 SearchDirection。
UP
:按照消息中的时间戳的逆序查询;DOWN
:按照消息中的时间戳的正序查询。从本地数据库获取指定会话的一定数量的特定类型的消息。
消息类型。详见 ContentType。
查询的起始消息 Unix 时间戳,单位为毫秒。该参数设置后,SDK 从指定时间戳的消息开始,按消息搜索方向获取。 如果该参数设置为负数,SDK 从当前时间开始搜索。
每次获取的最大消息数。取值范围为 [1,400]。
Optional
from: string单聊或群聊中的消息发送方的用户 ID。若设置为空字符串,SDK 将在整个会话中搜索消息。
Optional
direction: SearchDirection消息搜索方向。详见 SearchDirection。
UP
:按照消息中的时间戳的逆序查询;DOWN
:按照消息中的时间戳的正序查询。按照消息类型从本地数据库搜索消息。
消息类型数组。详见 ContentType。消息类型数组不可为空。
查询的起始消息 Unix 时间戳,单位为毫秒。该参数设置后,SDK 从指定时间戳的消息开始,按消息搜索方向获取。 如果该参数设置为负数,SDK 从当前时间开始搜索。
每次获取的最大消息数。取值范围为 [1,400]。
Optional
from: string消息发送方的用户 ID。若不设置或设置为空字符串,搜索消息时不限制于发送方的消息。
Optional
direction: SearchDirection消息搜索方向。详见 SearchDirection。
UP
:按照消息中的时间戳的逆序查询;DOWN
:按照消息中的时间戳的正序查询。发送消息。
如果是语音,图片类等有附件的消息,SDK 会自动上传附件。
可以通过 ChatOptions#setAutoTransferMessageAttachments 设置是否上传到聊天服务器。
发送消息的状态,可以通过设置 ChatMessage#setMessageStatusCallback 进行监听。
要发送的消息,必填。
更新本地消息。
要更新的消息对象。
聊天管理类,该类负责管理会话(加载,删除等)、发送消息、下载消息附件等。
发送文本消息示例如下: