继承自 com.hyphenate.chat.EMBase< T > .

类
enum	EMConversationType

enum	EMSearchDirection

class	MessageCache

Public 成员函数
String	conversationId ()

EMConversationType	getType ()

int	getUnreadMsgCount ()

void	markAllMessagesAsRead ()

int	getAllMsgCount ()

boolean	isChatThread ()

List< EMMessage >	loadMoreMsgFromDB (String startMsgId, int pageSize)

List< EMMessage >	loadMoreMsgFromDB (String startMsgId, int pageSize, EMSearchDirection direction)

List< EMMessage >	searchMsgFromDB (long timeStamp, int maxCount, EMSearchDirection direction)

List< EMMessage >	searchMsgFromDB (EMMessage.Type type, long timeStamp, int maxCount, String from, EMSearchDirection direction)

List< EMMessage >	searchMsgFromDB (String keywords, long timeStamp, int maxCount, String from, EMSearchDirection direction)

List< EMMessage >	searchMsgFromDB (long startTimeStamp, long endTimeStamp, int maxCount)

List< EMMessage >	searchCustomMsgFromDB (String keywords, long timeStamp, int maxCount, String from, EMSearchDirection direction)

EMMessage	getMessage (String messageId, boolean markAsRead)

void	markMessageAsRead (String messageId)

List< EMMessage >	getAllMessages ()

void	removeMessage (String messageId)

EMMessage	getLastMessage ()

EMMessage	getLatestMessageFromOthers ()

void	clear ()

void	clearAllMessages ()

void	setExtField (String ext)

String	getExtField ()

boolean	isGroup ()

boolean	insertMessage (EMMessage msg)

boolean	appendMessage (EMMessage msg)

boolean	updateMessage (EMMessage msg)

String	getMessageAttachmentPath ()

void	removeMessagesFromServer (List< String > msgIdList, EMCallBack callBack)

void	removeMessagesFromServer (long beforeTimeStamp, EMCallBack callBack)

静态 Public 成员函数
static EMConversationType	msgType2ConversationType (String id, EMMessage.ChatType type)

详细描述

会话类，用于定义单聊会话、群聊会话和聊天室会话。

每类会话中包含发送和接收的消息。

例如，从会话中获取未读消息数：

// conversationId 可以为聊天的另一方 ID，群组 ID 或者聊天室 ID。
EMConversation conversation = EMClient.getInstance().chatManager().getConversation(conversationId);
int unread = conversation.getUnreadMsgCount();

版本: 3.0

成员函数说明

◆ appendMessage()

boolean com.hyphenate.chat.EMConversation.appendMessage ( EMMessage msg )

在本地数据库中会话的尾部插入一条消息。

消息的会话 ID 应与会话的 ID 一致。

消息插入后，SDK 会自动更新会话的 latestMessage 等属性。

参数

msg 消息实例。

◆ clear()

void com.hyphenate.chat.EMConversation.clear ( )

清除会话中的所有消息。

只清除内存的，不清除本地数据库的消息。

在退出会话的时候清除内存缓存，减小内存消耗。

◆ clearAllMessages()

void com.hyphenate.chat.EMConversation.clearAllMessages ( )

清除内存和数据库中指定会话中的消息。

◆ conversationId()

String com.hyphenate.chat.EMConversation.conversationId ( )

会话 ID，取决于会话类型。

单聊/help desk：会话 ID 为对方的用户 ID。
群聊：会话 ID 为群组 ID。
聊天室：会话 ID 为聊天室的 ID。

返回: 会话 ID。

◆ getAllMessages()

List< EMMessage > com.hyphenate.chat.EMConversation.getAllMessages ( )

获取该会话当前内存中的所有消息。

如果内存中为空，SDK 再从本地数据库中加载最近一条消息。

返回: 消息列表。

◆ getAllMsgCount()

int com.hyphenate.chat.EMConversation.getAllMsgCount ( )

获取 SDK 本地数据库中会话的全部消息数。

返回: 会话的全部消息数量。

◆ getExtField()

String com.hyphenate.chat.EMConversation.getExtField ( )

获取会话的扩展字段。

扩展字段只在本地数据库中保存，不同步到服务器。

子区会话的扩展字段不在本地数据库中保存。

返回: 会话的扩展字段。

◆ getLastMessage()

EMMessage com.hyphenate.chat.EMConversation.getLastMessage ( )

获取会话中的最新一条消息。

此操作不会改变未读消息计数。

SDK 首先在内存中查找消息，若在内存中未找到，SDK 会在本地数据库查询并加载。

返回: 消息。

◆ getLatestMessageFromOthers()

EMMessage com.hyphenate.chat.EMConversation.getLatestMessageFromOthers ( )

获取会话中收到的最新一条消息。

返回: 消息。

◆ getMessage()

EMMessage com.hyphenate.chat.EMConversation.getMessage	(	String	messageId,
		boolean	markAsRead
	)

根据消息 ID 获取已读的消息。

SDK 首先在内存中查找消息，若在内存中未找到，SDK 会在本地数据库查询并加载。

参数

messageId	消息 ID。
markAsRead	是否将获取的消息标为已读。 `true`：是。 `false`：否

返回: 获取到的消息实例。

◆ getMessageAttachmentPath()

String com.hyphenate.chat.EMConversation.getMessageAttachmentPath ( )

获取会话对应的附件的存储路径。

该方法适用于清理会话数据前，如果不确定该路径一定存在，请调用该方法前查询路径。如有必要，添加异常保护。

返回: 附件存储路径。

◆ getType()

EMConversationType com.hyphenate.chat.EMConversation.getType ( )

获取会话类型。

返回: 会话类型。

◆ getUnreadMsgCount()

int com.hyphenate.chat.EMConversation.getUnreadMsgCount ( )

获取会话中未读的消息数量。

返回: 未读的消息数量。

◆ insertMessage()

boolean com.hyphenate.chat.EMConversation.insertMessage ( EMMessage msg )

在本地数据库的会话中插入一条消息。

消息的会话 ID 应与会话的 ID 一致。

消息会根据消息里的 Unix 时间戳插入本地数据库，SDK 会更新会话的 latestMessage 等属性。

参数

msg 消息实例。

◆ isChatThread()

boolean com.hyphenate.chat.EMConversation.isChatThread ( )

查看当前会话是否是子区会话。

返回

返回是否是子区会话的结果。

true 表示是子区会话。
false 表示不是子区会话。

◆ isGroup()

boolean com.hyphenate.chat.EMConversation.isGroup ( )

获取是否是群组或者聊天室会话。

返回: 群组和聊天室类型都会返回 true，其他类型返回 false。

◆ loadMoreMsgFromDB() [1/2]

List< EMMessage > com.hyphenate.chat.EMConversation.loadMoreMsgFromDB	(	String	startMsgId,
		int	pageSize
	)

从 SDK 本地数据库中分页加载消息。

加载的消息会基于消息中的时间戳放入当前会话的缓存中，调用 getAllMessages() 时会返回所有加载的消息。

参数

startMsgId	查询的起始消息 ID。SDK 从该消息 ID 开始按消息时间戳的逆序加载。如果传入消息的 ID 为空，SDK 从最新消息开始按消息时间戳的逆序获取。
pageSize	每页期望加载的消息数。取值范围为 [1,400]。

返回: 消息列表（不包含查询起始 ID 的消息）。

◆ loadMoreMsgFromDB() [2/2]

List< EMMessage > com.hyphenate.chat.EMConversation.loadMoreMsgFromDB	(	String	startMsgId,
		int	pageSize,
		EMSearchDirection	direction
	)

从指定消息 ID 开始分页加载数据库中的消息。

加载到的消息会加入到当前会话的消息中。

参数

startMsgId	查询的起始消息 ID。该参数设置后，SDK 从指定的消息 ID 开始按消息检索方向加载。如果传入消息的 ID 为空，SDK 忽略该参数，按搜索方向查询消息：若 `direction` 为 `UP`，SDK 从最新消息开始，按消息时间戳的倒序获取；若 `direction` 为 `DOWN`，SDK 从最早消息开始，按消息时间戳的正序获取。
pageSize	每页期望加载的消息数。取值范围为 [1,40]。
direction	消息搜索方向。详见 EMSearchDirection。 `UP`：按照消息中的时间戳的逆序查询； `DOWN`：按照消息中的时间戳的正序查询；

返回: 消息列表（不包含查询起始时间戳对应的消息）。

◆ markAllMessagesAsRead()

void com.hyphenate.chat.EMConversation.markAllMessagesAsRead ( )

将所有未读消息设置为已读。

◆ markMessageAsRead()

void com.hyphenate.chat.EMConversation.markMessageAsRead ( String messageId )

设置指定消息为已读。

也可调用 EMMessage#setUnread(boolean) 将消息置为已读。

参数

messageId 消息 ID。

◆ msgType2ConversationType()

static EMConversationType com.hyphenate.chat.EMConversation.msgType2ConversationType	(	String	id,
		EMMessage.ChatType	type
	)

static

将消息类型转化为会话类型。

参数

id	消息 ID。
type	消息类型。

返回: 会话类型。

◆ removeMessage()

void com.hyphenate.chat.EMConversation.removeMessage ( String messageId )

删除本地数据库中的一条指定消息。

参数

messageId 待删除消息的 ID。

◆ removeMessagesFromServer() [1/2]

void com.hyphenate.chat.EMConversation.removeMessagesFromServer	(	List< String >	msgIdList,
		EMCallBack	callBack
	)

单向删除漫游消息（根据msgId删除）

参数

msgIdList	msgId列表
callBack	处理结果回调,详见 EMCallBack。

◆ removeMessagesFromServer() [2/2]

void com.hyphenate.chat.EMConversation.removeMessagesFromServer	(	long	beforeTimeStamp,
		EMCallBack	callBack
	)

单向删除漫游消息（根据时间节点删除只支持按开始时间向上删除）

参数

beforeTimeStamp	开始时间单位毫秒
callBack	处理结果回调,详见 EMCallBack。

◆ searchCustomMsgFromDB()

List< EMMessage > com.hyphenate.chat.EMConversation.searchCustomMsgFromDB	(	String	keywords,
		long	timeStamp,
		int	maxCount,
		String	from,
		EMSearchDirection	direction
	)

从本地数据库获取会话中的指定用户发送的包含特定关键词的自定义消息。

参数

keywords	搜索的关键词。
timeStamp	查询的起始消息 Unix 时间戳，单位为毫秒。该参数设置后，SDK 从指定时间戳的消息开始，按消息搜索方向获取。如果该参数设置为负数，SDK 从当前时间开始搜索。
maxCount	每次获取的最大消息数。取值范围为 [1,400]。
from	搜索来自指定用户或者群组的消息，一般为会话 ID。
direction	消息加载方向。详见 EMSearchDirection。

返回: 消息列表（不包含查询起始时间戳对应的消息）。

◆ searchMsgFromDB() [1/4]

List< EMMessage > com.hyphenate.chat.EMConversation.searchMsgFromDB	(	EMMessage.Type	type,
		long	timeStamp,
		int	maxCount,
		String	from,
		EMSearchDirection	direction
	)

从本地数据库获取指定会话的一定数量的特定类型的消息。

参数

type	消息类型。详见 Type。
timeStamp	查询的起始消息 Unix 时间戳，单位为毫秒。该参数设置后，SDK 从指定时间戳的消息开始，按消息搜索方向获取。
maxCount	每次获取的最大消息数。取值范围为 [1,400]。
from	搜索来自指定用户或者群组的消息，一般为会话 ID。
direction	消息搜索方向。详见 EMSearchDirection。 `UP`：按照消息中的时间戳的逆序查询； `DOWN`：按照消息中的时间戳的正序查询。

返回: 消息列表（不包含查询起始时间戳对应的消息）。

◆ searchMsgFromDB() [2/4]

List< EMMessage > com.hyphenate.chat.EMConversation.searchMsgFromDB	(	long	startTimeStamp,
		long	endTimeStamp,
		int	maxCount
	)

从本地数据库中搜索指定时间段内发送或接收的一定数量的消息。

参数

startTimeStamp	搜索的起始时间戳。单位为毫秒。详见 EMOptions#setSortMessageByServerTime。
endTimeStamp	搜索的结束时间戳。单位为毫秒。详见 EMOptions#setSortMessageByServerTime。
maxCount	每次获取的最大消息数量。取值范围为 [1,400]。

返回: 消息列表（不包含搜索起始时间戳和结束时间戳对应的消息）。

◆ searchMsgFromDB() [3/4]

List< EMMessage > com.hyphenate.chat.EMConversation.searchMsgFromDB	(	long	timeStamp,
		int	maxCount,
		EMSearchDirection	direction
	)

基于 Unix 时间戳搜索本地数据库中的消息。

参数

timeStamp	查询的起始消息 Unix 时间戳，单位为毫秒。该参数设置后，SDK 从指定时间戳的消息开始，按消息搜索方向获取。如果该参数设置为负数，SDK 从最新消息获取。
maxCount	每次获取的最大消息数。取值范围为 [1,400]。
direction	消息搜索方向。详见 EMSearchDirection。 `UP`：按照消息中的时间戳的逆序查询； `DOWN`：按照消息中的时间戳的正序查询。

返回: 消息列表（不包含查询起始时间戳对应的消息）。

◆ searchMsgFromDB() [4/4]

List< EMMessage > com.hyphenate.chat.EMConversation.searchMsgFromDB	(	String	keywords,
		long	timeStamp,
		int	maxCount,
		String	from,
		EMSearchDirection	direction
	)

从本地数据库获取会话中的指定用户发送的包含特定关键词的消息。

参数

keywords	查询的关键字。
timeStamp	查询的起始消息 Unix 时间戳，单位为毫秒。该参数设置后，SDK 从指定时间戳的消息开始，按消息搜索方向获取。如果该参数设置为负数，SDK 从当前时间开始搜索。
maxCount	每次获取的最大消息数。取值范围为 [1,400]。
from	搜索来自指定用户或者群组的消息，一般为会话 ID。
direction	消息搜索方向。详见 EMSearchDirection。 `UP`：按照消息中的时间戳的逆序查询； `DOWN`：按照消息中的时间戳的正序查询。

返回: 消息列表（不包含查询起始时间戳对应的消息）。

◆ setExtField()

void com.hyphenate.chat.EMConversation.setExtField ( String ext )

设置会话的扩展字段。

扩展字段只在本地数据库中保存，不同步到服务器。

子区会话的扩展字段不在本地数据库中保存。

参数

ext 会话的扩展字段。

◆ updateMessage()

boolean com.hyphenate.chat.EMConversation.updateMessage ( EMMessage msg )

更新本地数据库的指定消息。

消息更新时，消息 ID 不会修改。

消息更新后，SDK 会自动更新会话的 latestMessage 等属性。

参数

msg 要更新的消息。

该类的文档由以下文件生成:

com/hyphenate/chat/EMConversation.java

类

Public 成员函数

静态 Public 成员函数

详细描述

成员函数说明

◆ appendMessage()

◆ clear()

◆ clearAllMessages()

◆ conversationId()

◆ getAllMessages()

◆ getAllMsgCount()

◆ getExtField()

◆ getLastMessage()

◆ getLatestMessageFromOthers()

◆ getMessage()

◆ getMessageAttachmentPath()

◆ getType()

◆ getUnreadMsgCount()

◆ insertMessage()

◆ isChatThread()

◆ isGroup()

◆ loadMoreMsgFromDB() [1/2]

◆ loadMoreMsgFromDB() [2/2]

◆ markAllMessagesAsRead()

◆ markMessageAsRead()

◆ msgType2ConversationType()

◆ removeMessage()

◆ removeMessagesFromServer() [1/2]

◆ removeMessagesFromServer() [2/2]

◆ searchCustomMsgFromDB()

◆ searchMsgFromDB() [1/4]

◆ searchMsgFromDB() [2/4]

◆ searchMsgFromDB() [3/4]

◆ searchMsgFromDB() [4/4]

◆ setExtField()

◆ updateMessage()