Public 成员函数
void	sendMessage (final EMMessage msg)

void	ackConversationRead (String conversationId) throws HyphenateException

void	ackMessageRead (String to, String messageId) throws HyphenateException

void	ackGroupMessageRead (String to, String messageId, String ext) throws HyphenateException

void	recallMessage (EMMessage message) throws HyphenateException

void	aysncRecallMessage (final EMMessage message, final EMCallBack callback)

EMMessage	getMessage (String messageId)

EMConversation	getConversation (String id)

EMConversation	getConversation (String id, EMConversationType type)

EMConversation	getConversation (String username, EMConversationType type, boolean createIfNotExists)

EMConversation	getConversation (String username, EMConversationType type, boolean createIfNotExists, boolean isChatThread)

void	markAllConversationsAsRead ()

int	getUnreadMsgsCount ()

int	getUnreadMessageCount ()

void	saveMessage (EMMessage message)

boolean	updateMessage (EMMessage message)

void	downloadAttachment (final EMMessage msg)

void	downloadThumbnail (final EMMessage msg)

synchronized void	importMessages (List< EMMessage > msgs)

List< EMConversation >	getConversationsByType (EMConversationType type)

void	downloadFile (final String remoteUrl, final String localFilePath, final Map< String, String > headers, final EMCallBack callback)

Map< String, EMConversation >	getAllConversations ()

Map< String, EMConversation >	fetchConversationsFromServer () throws HyphenateException

void	asyncFetchConversationsFromServer (final EMValueCallBack< Map< String, EMConversation > > callBack)

void	loadAllConversations ()

boolean	deleteConversation (String username, boolean deleteMessages)

void	deleteConversationFromServer (String username, EMConversationType type, boolean isDeleteServerMessages, EMCallBack deleteCallBack)

void	addMessageListener (EMMessageListener listener)

void	removeMessageListener (EMMessageListener listener)

void	addConversationListener (EMConversationListener listener)

void	removeConversationListener (EMConversationListener listener)

void	setMessageListened (EMMessage message)

void	setVoiceMessageListened (EMMessage message)

boolean	updateParticipant (String from, String changeTo)

EMCursorResult< EMGroupReadAck >	fetchGroupReadAcks (String msgId, int pageSize, String startAckId) throws HyphenateException

void	asyncFetchGroupReadAcks (final String msgId, final int pageSize, final String startAckId, final EMValueCallBack< EMCursorResult< EMGroupReadAck > > callBack)

EMCursorResult< EMMessage >	fetchHistoryMessages (String conversationId, EMConversationType type, int pageSize, String startMsgId) throws HyphenateException

EMCursorResult< EMMessage >	fetchHistoryMessages (String conversationId, EMConversationType type, int pageSize, String startMsgId, EMConversation.EMSearchDirection direction) throws HyphenateException

void	asyncFetchHistoryMessage (final String conversationId, final EMConversationType type, final int pageSize, final String startMsgId, final EMValueCallBack< EMCursorResult< EMMessage > > callBack)

void	asyncFetchHistoryMessage (final String conversationId, final EMConversationType type, final int pageSize, final String startMsgId, final EMConversation.EMSearchDirection direction, final EMValueCallBack< EMCursorResult< EMMessage > > callBack)

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

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

void	deleteMessagesBeforeTimestamp (long timeStamp, EMCallBack callback)

void	asyncReportMessage (String msgId, String reportTarget, String reportReason, EMCallBack callBack)

void	reportMessage (String msgId, String reportTarget, String reportReason) throws HyphenateException

void	fetchSupportLanguages (EMValueCallBack< List< EMLanguage > > callBack)

void	translateMessage (EMMessage message, List< String > languages, EMValueCallBack< EMMessage > callBack)

void	addReaction (final String messageId, final String reaction) throws HyphenateException

void	asyncAddReaction (final String messageId, final String reaction, final EMCallBack callback)

void	removeReaction (final String messageId, final String reaction) throws HyphenateException

void	asyncRemoveReaction (final String messageId, final String reaction, final EMCallBack callback)

Map< String, List< EMMessageReaction > >	getReactionList (final List< String > messageIdList, final EMMessage.ChatType chatType, final String groupId) throws HyphenateException

void	asyncGetReactionList (final List< String > messageIdList, final EMMessage.ChatType chatType, final String groupId, final EMValueCallBack< Map< String, List< EMMessageReaction > > > callback)

EMCursorResult< EMMessageReaction >	getReactionDetail (final String messageId, final String reaction, final String cursor, final int pageSize) throws HyphenateException

void	asyncGetReactionDetail (final String messageId, final String reaction, final String cursor, final int pageSize, final EMValueCallBack< EMCursorResult< EMMessageReaction > > callback)

Protected 成员函数
	EMChatManager (EMClient client, EMAChatManager manager, EMAReactionManager reactionManager)

详细描述

聊天管理类，该类负责管理会话（加载，删除等）、发送消息、下载消息附件等。

比如，发送一条文本消息：

EMMessage message = EMMessage.createTxtSendMessage(content, toChatUsername);

EMClient.getInstance().chatManager().sendMessage(message);

成员函数说明

◆ ackConversationRead()

void com.hyphenate.chat.EMChatManager.ackConversationRead ( String conversationId ) throws HyphenateException

发送会话的已读回执，该方法只针对单聊会话。

该方法会通知服务器将此会话未读数设置为 0，对话方（包含多端多设备）将会在下面这个回调方法中接收到回调：

EMConversationListener#onConversationRead(String, String) 。

参考：群消息已读回执，详见 ackGroupMessageRead(String, String, String)。

参数

conversationId 会话 ID。

异常

HyphenateException 以下为可能抛出的异常：EMError#USER_NOT_LOGIN、EMError#SERVER_NOT_REACHABLE、 EMError#MESSAGE_INVALID 等，详见 EMError。

◆ ackGroupMessageRead()

void com.hyphenate.chat.EMChatManager.ackGroupMessageRead	(	String	to,
		String	messageId,
		String	ext
	)		throws HyphenateException

发送群消息已读回执。

前提条件：设置了 EMOptions#setRequireAck(boolean) 和 EMMessage#setIsNeedGroupAck(boolean)。

参考：发送单聊消息已读回执，详见 ackMessageRead(String, String) ; 会话已读回执，详见 ackConversationRead(String)。

参数

to	会话 ID。
messageId	消息 ID。
ext	扩展信息。`ext` 属性是用户自己定义的关键字，接收后，解析出自定义的字符串，可以自行处理。

异常

HyphenateException 如果有异常会在这里抛出，包含错误码和错误描述，详见 EMError。

◆ ackMessageRead()

void com.hyphenate.chat.EMChatManager.ackMessageRead	(	String	to,
		String	messageId
	)		throws HyphenateException

发送消息的已读回执。

该方法仅适用于单聊会话。

注意：如果设置 EMOptions#setRequireAck(boolean) 为 false，当前方法将失效。

发送群消息已读回执，详见 ackGroupMessageRead(String, String, String)。

建议：在进入聊天页面的时调用 ackConversationRead(String) ，其他场景再调用此方法，可以大量减少调用此方法的次数。

参数

to	接收方的用户名。
messageId	消息的 ID。

异常

HyphenateException 如果有异常会在这里抛出，包含错误码和错误描述，详见 EMError。

◆ addConversationListener()

void com.hyphenate.chat.EMChatManager.addConversationListener ( EMConversationListener listener )

注册会话监听。

用于监听会话变化及监听会话已读回执，详见 EMConversationListener。

需要配合 removeConversationListener(EMConversationListener) 使用。

参数

listener 要添加的会话监听，详见 EMConversationListener。

◆ addMessageListener()

void com.hyphenate.chat.EMChatManager.addMessageListener ( EMMessageListener listener )

注册消息监听。

接受到新消息等回调可以通过设置此方法进行监听，详见 EMMessageListener。

如果需要移除监听，可以和 removeMessageListener(EMMessageListener) 方法配合使用。

参数

listener 要注册的消息监听，详见 EMMessageListener。

◆ addReaction()

void com.hyphenate.chat.EMChatManager.addReaction	(	final String	messageId,
		final String	reaction
	)		throws HyphenateException

添加 Reaction。

同步方法。

参数

messageId	消息 ID。
reaction	消息 Reaction 内容。

◆ asyncAddReaction()

void com.hyphenate.chat.EMChatManager.asyncAddReaction	(	final String	messageId,
		final String	reaction,
		final EMCallBack	callback
	)

添加 Reaction。

异步方法。

参数

messageId	消息 ID。
reaction	消息 Reaction。
callback	处理结果回调，详见 EMCallBack。

◆ asyncFetchConversationsFromServer()

void com.hyphenate.chat.EMChatManager.asyncFetchConversationsFromServer ( final EMValueCallBack< Map< String, EMConversation > > callBack )

从服务器获取会话列表。该功能需联系商务开通，开通后，用户默认可拉取 7 天内的 10 个会话（每个会话包含最新一条历史消息），如需调整会话数量或时间限制请联系商务经理。

异步方法。

返回: 返回当前用户的会话列表。

◆ asyncFetchGroupReadAcks()

void com.hyphenate.chat.EMChatManager.asyncFetchGroupReadAcks	(	final String	msgId,
		final int	pageSize,
		final String	startAckId,
		final EMValueCallBack< EMCursorResult< EMGroupReadAck > >	callBack
	)

从服务器获取群组消息回执详情。

分页获取。

参考：发送群组消息回执，详见 ackGroupMessageRead(String, String, String)。

异步方法。

参数

msgId	消息 ID。
pageSize	每页获取群消息已读回执的条数。
startAckId	已读回执的 ID，如果为空，从最新的回执向前开始获取。
callBack	结果回调，成功执行 EMValueCallBack#onSuccess(Object)，失败执行 EMValueCallBack#onError(int, String)。

◆ asyncFetchHistoryMessage() [1/2]

void com.hyphenate.chat.EMChatManager.asyncFetchHistoryMessage	(	final String	conversationId,
		final EMConversationType	type,
		final int	pageSize,
		final String	startMsgId,
		final EMConversation.EMSearchDirection	direction,
		final EMValueCallBack< EMCursorResult< EMMessage > >	callBack
	)

从服务器获取历史消息。

分页获取。

异步方法。

参数

conversationId	会话 ID。
type	会话类型，详见 EMConversationType。
pageSize	每页获取的条数。
startMsgId	漫游消息的开始消息 ID，如果为空，根据 direction , 当检索方向为 com.hyphenate.chat.EMConversation.EMSearchDirection#UP 时，从最新的消息向前开始获取；当检索方向为 com.hyphenate.chat.EMConversation.EMSearchDirection#DOWN 时，从最旧的消息向后开始获取。
direction	漫游消息检索方向，com.hyphenate.chat.EMConversation.EMSearchDirection#UP为检索时间戳消息小于开始消息时间戳的消息，com.hyphenate.chat.EMConversation.EMSearchDirection#DOWN 为检索时间戳消息大于开始消息时间戳的消息。
callBack	结果回调，成功则执行 EMValueCallBack#onSuccess(Object), 返回消息列表和用于继续获取历史消息的 Cursor; 失败则执行 EMValueCallBack#onError(int, String)。

◆ asyncFetchHistoryMessage() [2/2]

void com.hyphenate.chat.EMChatManager.asyncFetchHistoryMessage	(	final String	conversationId,
		final EMConversationType	type,
		final int	pageSize,
		final String	startMsgId,
		final EMValueCallBack< EMCursorResult< EMMessage > >	callBack
	)

从服务器获取历史消息。

分页获取。

异步方法。

参数

conversationId	会话 ID。
type	会话类型，详见 EMConversationType。
pageSize	每页获取的条数。
startMsgId	漫游消息的开始消息 ID，如果为空，从最新的消息向前开始获取。
callBack	结果回调，成功则执行 EMValueCallBack#onSuccess(Object), 返回消息列表和用于继续获取历史消息的 Cursor; 失败则执行 EMValueCallBack#onError(int, String)。

◆ asyncGetReactionDetail()

void com.hyphenate.chat.EMChatManager.asyncGetReactionDetail	(	final String	messageId,
		final String	reaction,
		final String	cursor,
		final int	pageSize,
		final EMValueCallBack< EMCursorResult< EMMessageReaction > >	callback
	)

获取 Reaction 详细信息。

异步方法。

参数

messageId	消息 ID。
reaction	消息 Reaction。
cursor	查询 cursor。
pageSize	每页获取的 Reaction 条数。
callback	处理结果回调，包含 cursor 和 EMMessageReaction 列表（仅使用该列表第一个数据即可）。

◆ asyncGetReactionList()

void com.hyphenate.chat.EMChatManager.asyncGetReactionList	(	final List< String >	messageIdList,
		final EMMessage.ChatType	chatType,
		final String	groupId,
		final EMValueCallBack< Map< String, List< EMMessageReaction > > >	callback
	)

获取 Reaction 列表。

异步方法。

参数

messageIdList	消息 ID。
chatType	会话类型，仅支持单聊（ EMMessage.ChatType#Chat ）和群聊（EMMessage.ChatType#GroupChat）。
groupId	群组 ID，该参数只在群聊生效。
callback	处理结果回调，包含消息 ID 对应的 Reaction 列表（EMMessageReaction 的用户列表为概要数据，只包含前三个用户信息）。

◆ asyncRemoveReaction()

void com.hyphenate.chat.EMChatManager.asyncRemoveReaction	(	final String	messageId,
		final String	reaction,
		final EMCallBack	callback
	)

删除 Reaction。

异步方法。

参数

messageId	消息 ID。
reaction	消息 Reaction。
callback	处理结果回调，详见 EMCallBack。

◆ asyncReportMessage()

void com.hyphenate.chat.EMChatManager.asyncReportMessage	(	String	msgId,
		String	reportTarget,
		String	reportReason,
		EMCallBack	callBack
	)

举报违规消息

参数

msgId	违规的消息id。
reportTarget	举报类型(例如：涉黄、涉恐)
reportReason	举报原因。
callBack	执行上报结果成功执行 EMCallBack#onSuccess()，失败执行EMCallBack#onError(int, String)

◆ aysncRecallMessage()

void com.hyphenate.chat.EMChatManager.aysncRecallMessage	(	final EMMessage	message,
		final EMCallBack	callback
	)

撤回发送成功的消息。

异步方法。

参数

message	消息对象。
callback	一个 EMCallBack 类型的对象，详见 EMCallBack。

◆ deleteConversation()

boolean com.hyphenate.chat.EMChatManager.deleteConversation	(	String	username,
		boolean	deleteMessages
	)

删除指定 ID 的对话和本地的聊天记录。如果将 deleteMessages 设为 true，删除会话的同时也会删除本地的聊天记录。

参数

username	会话 ID。
deleteMessages	是否同时删除本地的聊天记录。`true 表示删除； false 表示不删除。`

返回

 删除会话结果。
true 代表删除成功；
false 代表删除失败。

◆ deleteConversationFromServer()

void com.hyphenate.chat.EMChatManager.deleteConversationFromServer	(	String	username,
		EMConversationType	type,
		boolean	isDeleteServerMessages,
		EMCallBack	deleteCallBack
	)

删除服务端的指定 ID 的对话和聊天记录，内部异步操作。

参数

username	会话 ID。
type	会话类型 EMConversationType
isDeleteServerMessages	是否同时删除服务端的聊天记录。 `true`：删除服务端会话的同时也会删除服务端的聊天记录。 `false` 表示删除服务端会话的同时不删除服务端的聊天记录。
deleteCallBack	删除服务端会话与记录成功与否的回调。 `true` 代表删除成功； `false` 代表删除失败。

◆ deleteMessagesBeforeTimestamp()

void com.hyphenate.chat.EMChatManager.deleteMessagesBeforeTimestamp	(	long	timeStamp,
		EMCallBack	callback
	)

删除时间戳之前的本地消息记录。

参数

timeStamp	Unix 时间戳，单位为毫秒。
callback	删除结果回调，详见 EMCallBack。

◆ downloadAttachment()

void com.hyphenate.chat.EMChatManager.downloadAttachment ( final EMMessage msg )

下载消息的附件。

未成功下载的附件，可调用此方法再次下载。

参数

msg 要下载附件的消息。

◆ downloadFile()

void com.hyphenate.chat.EMChatManager.downloadFile	(	final String	remoteUrl,
		final String	localFilePath,
		final Map< String, String >	headers,
		final EMCallBack	callback
	)

从服务器下载文件。

参数

remoteUrl	服务器上的远程文件路径。
localFilePath	本地要生成的文件路径。
headers	请求头。
callback	下载结果回调，详见 EMCallBack。

弃用:: 使用 downloadAttachment(EMMessage) 代替。

◆ downloadThumbnail()

void com.hyphenate.chat.EMChatManager.downloadThumbnail ( final EMMessage msg )

下载消息的缩略图。

参数

msg	要下载缩略图的消息，一般图片消息和视频消息有缩略图。

◆ fetchConversationsFromServer()

Map< String, EMConversation > com.hyphenate.chat.EMChatManager.fetchConversationsFromServer ( ) throws HyphenateException

从服务器获取会话列表。该功能需联系商务开通，开通后，用户默认可拉取 7 天内的 10 个会话（每个会话包含最新一条历史消息），如需调整会话数量或时间限制请联系商务经理。

同步方法，会阻塞当前线程。

返回: 返回当前用户的会话列表。

◆ fetchGroupReadAcks()

EMCursorResult< EMGroupReadAck > com.hyphenate.chat.EMChatManager.fetchGroupReadAcks	(	String	msgId,
		int	pageSize,
		String	startAckId
	)		throws HyphenateException

从服务器获取群组消息回执详情。

分页获取。

参考：发送群组消息回执，详见 ackGroupMessageRead(String, String, String)。

同步方法，会阻塞当前线程。

参数

msgId	需要获取回执的消息 ID。
pageSize	每次获取群消息已读回执的条数。
startAckId	已读回执的 ID，可以为空。如果为空，从最新的回执向前开始获取。

返回: 返回消息列表和用于继续获取群消息回执的 Cursor。

异常

HyphenateException 如果有异常会在这里抛出，包含错误码和错误描述，详见 EMError。

◆ fetchHistoryMessages() [1/2]

EMCursorResult< EMMessage > com.hyphenate.chat.EMChatManager.fetchHistoryMessages	(	String	conversationId,
		EMConversationType	type,
		int	pageSize,
		String	startMsgId
	)		throws HyphenateException

从服务器获取历史消息。

分页获取。

同步方法，会阻塞当前线程。

参数

conversationId	会话 ID。
type	会话类型, 详见 EMConversationType。
pageSize	每页获取的条数。
startMsgId	漫游消息的开始消息 ID，如果为空，从最新的消息向前开始获取。

返回: 返回消息列表和用于继续获取历史消息的 Cursor。

异常

HyphenateException 如果有异常会在这里抛出，包含错误码和错误描述，详见 EMError。

◆ fetchHistoryMessages() [2/2]

EMCursorResult< EMMessage > com.hyphenate.chat.EMChatManager.fetchHistoryMessages	(	String	conversationId,
		EMConversationType	type,
		int	pageSize,
		String	startMsgId,
		EMConversation.EMSearchDirection	direction
	)		throws HyphenateException

从服务器获取历史消息。

分页获取。

同步方法，会阻塞当前线程。

参数

conversationId	会话 ID。
type	会话类型, 详见 EMConversationType。
pageSize	每页获取的条数。
startMsgId	漫游消息的开始消息 ID，如果为空，根据 direction , 当检索方向为 com.hyphenate.chat.EMConversation.EMSearchDirection#UP 时，从最新的消息向前开始获取；当检索方向为 com.hyphenate.chat.EMConversation.EMSearchDirection#DOWN 时，从最旧的消息向后开始获取。
direction	漫游消息检索方向，com.hyphenate.chat.EMConversation.EMSearchDirection#UP为检索时间戳消息小于开始消息时间戳的消息，com.hyphenate.chat.EMConversation.EMSearchDirection#DOWN 为检索时间戳消息大于开始消息时间戳的消息。

返回: 返回消息列表和用于继续获取历史消息的 Cursor。

异常

HyphenateException 如果有异常会在这里抛出，包含错误码和错误描述，详见 EMError。

◆ fetchSupportLanguages()

void com.hyphenate.chat.EMChatManager.fetchSupportLanguages ( EMValueCallBack< List< EMLanguage > > callBack )

获取翻译服务支持的语言

参数

callBack 完成回调

◆ getAllConversations()

Map< String, EMConversation > com.hyphenate.chat.EMChatManager.getAllConversations ( )

从本地获取当前所有的会话。

先从内存中加载，如果内存中没有再从数据库中加载。

返回: 返回本地内存或者数据库中所有的会话。

◆ getConversation() [1/4]

EMConversation com.hyphenate.chat.EMChatManager.getConversation ( String id )

获取定义 ID 的会话对象。

没有找到会返回空值。

参数

id 会话 ID。

返回: 根据指定会话 ID 找到的会话对象，如果没有找到会返回空值。

◆ getConversation() [2/4]

EMConversation com.hyphenate.chat.EMChatManager.getConversation	(	String	id,
		EMConversationType	type
	)

根据会话 ID 以及会话类型获取会话。

没有找到返回空值。

参数

id	会话 ID。
type	会话类型。

返回: 根据指定 ID 以及会话类型找到的会话对象，没有找到会返回空值。

◆ getConversation() [3/4]

EMConversation com.hyphenate.chat.EMChatManager.getConversation	(	String	username,
		EMConversationType	type,
		boolean	createIfNotExists
	)

根据用户或群组 ID 以及会话类型获取会话。

没有找到的话，可以根据 createIfNotExists 的值返回一个新建对象或者空对象。

参数

username	会话 ID。
type	会话类型。
createIfNotExists	没找到相应会话时是否自动创建。 `true` 表示没有找到相应会话时会自动创建会话； `false` 表示没有找到相应会话时不创建会话。

返回: 根据指定 ID 以及会话类型找到的会话对象，如果没有找到会返回空值。

◆ getConversation() [4/4]

EMConversation com.hyphenate.chat.EMChatManager.getConversation	(	String	username,
		EMConversationType	type,
		boolean	createIfNotExists,
		boolean	isChatThread
	)

根据用户或群组id以及会话类型获取会话。

没有找到的话，根据createIfNotExists的值返回一个新建对象或者空对象。

参数

username	会话ID。
type	会话类型。
createIfNotExists	没找到相应会话时是否自动创建。 `true` 表示没有找到相应会话时会自动创建会话； `false` 表示没有找到相应会话时不创建会话。
isChatThread	是否查找子区会话。 `true` 表示查找子区会话； `false` 表示不查找子区会话。

返回: 根据指定 ID 以及会话类型找到的会话对象，如果没有找到会返回空值。 EMChatManager#getConversation(String, EMConversationType, boolean, boolean)

◆ getConversationsByType()

List< EMConversation > com.hyphenate.chat.EMChatManager.getConversationsByType ( EMConversationType type )

获取指定会话类型所有的会话。

参数

type	会话类型，详见 EMConversationType。

返回: 返回指定会话类型的会话列表。

◆ getMessage()

EMMessage com.hyphenate.chat.EMChatManager.getMessage ( String messageId )

获取指定 ID 的消息对象。

参数

messageId 消息 ID。

返回: 根据指定 ID 获取的消息对象，如果消息不存在会返回空值。

◆ getReactionDetail()

EMCursorResult< EMMessageReaction > com.hyphenate.chat.EMChatManager.getReactionDetail	(	final String	messageId,
		final String	reaction,
		final String	cursor,
		final int	pageSize
	)		throws HyphenateException

获取 Reaction 详细信息。

同步方法。

参数

messageId	消息 ID。
reaction	消息 Reaction 内容。
cursor	查询 cursor。
pageSize	每页获取的 Reaction 条数。
cursor	返回 cursor 和 EMMessageReaction 列表（仅使用该列表第一个数据即可）。cursor 为空值说明数据已全部获取到。

返回: EMCursorResult 包含 cursor(cursor 为空表示数据已全部获取)和 EMMessageReaction 列表。

◆ getReactionList()

Map< String, List< EMMessageReaction > > com.hyphenate.chat.EMChatManager.getReactionList	(	final List< String >	messageIdList,
		final EMMessage.ChatType	chatType,
		final String	groupId
	)		throws HyphenateException

获取 Reaction 列表。

同步方法。

参数

messageIdList	消息 ID。
chatType	会话类型，仅支持单聊（ EMMessage.ChatType#Chat ）和群聊（EMMessage.ChatType#GroupChat）。
groupId	群组 ID，该参数只在群聊生效。

返回: map 指定消息 ID 对应的 Reaction 列表（EMMessageReaction 的 UserList 为概要数据，只包含前三个用户信息）。

◆ getUnreadMessageCount()

int com.hyphenate.chat.EMChatManager.getUnreadMessageCount ( )

获取未读消息数。

返回: 未读消息数。

◆ getUnreadMsgsCount()

int com.hyphenate.chat.EMChatManager.getUnreadMsgsCount ( )

获取未读消息数。

返回: 未读消息数。

弃用:: 使用 EMChatManager#getUnreadMessageCount() 替代。

◆ importMessages()

synchronized void com.hyphenate.chat.EMChatManager.importMessages ( List< EMMessage > msgs )

向消息数据库导入多条聊天记录。在调用此函数时要保证，消息的发送方或者接收方是当前用户。已经对函数做过速度优化，推荐一次导入 1,000 条以内的数据。

参数

msgs	需要导入数据库的消息。

◆ loadAllConversations()

void com.hyphenate.chat.EMChatManager.loadAllConversations ( )

从数据库加载本地所有的会话到内存中。一般在登录成功后使用此方法，可以加快会话列表的加载速度。

◆ markAllConversationsAsRead()

void com.hyphenate.chat.EMChatManager.markAllConversationsAsRead ( )

把所有的会话都设成已读。

这里针对的是本地会话。

◆ recallMessage()

void com.hyphenate.chat.EMChatManager.recallMessage ( EMMessage message ) throws HyphenateException

撤回发送成功的消息。

同步方法，会阻塞当前线程。

参数

message 消息对象。

异常

HyphenateException 如果有异常会在这里抛出，包含错误码和错误描述，详见 EMError。

◆ removeConversationListener()

void com.hyphenate.chat.EMChatManager.removeConversationListener ( EMConversationListener listener )

移除会话监听。

如果想要移除会话监听，需要先添加 addConversationListener(EMConversationListener) 后调用此方法进行移除。

参数

listener 准备移除的会话监听，详见 EMConversationListener。

◆ removeMessageListener()

void com.hyphenate.chat.EMChatManager.removeMessageListener ( EMMessageListener listener )

移除消息监听。

需要先添加 addMessageListener(EMMessageListener) 监听，再调用本方法。

参数

listener 要移除的监听，详见 EMMessageListener。

◆ removeReaction()

void com.hyphenate.chat.EMChatManager.removeReaction	(	final String	messageId,
		final String	reaction
	)		throws HyphenateException

删除 Reaction。

同步方法。

参数

messageId	消息 ID。
reaction	消息 Reaction。

异常

HyphenateException 如果有异常会在这里抛出，包含错误码和错误描述，详见 EMError。

◆ reportMessage()

void com.hyphenate.chat.EMChatManager.reportMessage	(	String	msgId,
		String	reportTarget,
		String	reportReason
	)		throws HyphenateException

举报违规消息。

同步方法，会阻塞当前线程。

参数

msgId	违规的消息id。
reportTarget	举报类型(例如：涉黄、涉恐)
reportReason	举报原因。

异常

HyphenateException 如果有异常会在这里抛出，包含错误码和错误描述，详见 EMError。

◆ saveMessage()

void com.hyphenate.chat.EMChatManager.saveMessage ( EMMessage message )

保存消息到本地。比如系统提示消息会存到内存中的会话和数据库。

注意： CMD 类型数据不保存在本地。

参数

message 待存储的消息。

◆ searchMsgFromDB() [1/2]

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

根据传入的参数从本地存储中搜索指定数量的消息。

注意：当 maxCount 非常大时，需要考虑内存消耗，目前限制一次最多搜索 400 条数据。

参数

type	消息类型，文本、图片、语音、视频等，详见 EMMessage.Type。
timeStamp	搜索消息的时间点，Unix 时间戳。
maxCount	搜索结果的最大条数。
from	搜索来自某人或者某群的消息，一般是指会话 ID。

返回: 消息列表。

◆ searchMsgFromDB() [2/2]

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

根据传入的参数从本地存储中搜索指定数量的消息。

注意：当 maxCount 非常大时，需要考虑内存消耗，目前限制一次最多搜索 400 条数据。

参数

keywords	搜索消息中的关键词。
timeStamp	搜索消息的时间点。
maxCount	一次搜索结果的最大条数。
from	搜索来自某人或者某群的消息，一般是指会话 ID。

返回: 消息列表。

◆ sendMessage()

void com.hyphenate.chat.EMChatManager.sendMessage ( final EMMessage msg )

发送消息。

参考：如果是语音，图片类等有附件的消息，SDK 会自动上传附件。可以通过 EMOptions#setAutoTransferMessageAttachments(boolean) 设置是否上传到聊天服务器。

发送消息的状态，可以通过设置 EMMessage#setMessageStatusCallback(EMCallBack) 进行监听。

参数

msg	待发送消息对象，不能为空。

◆ setMessageListened()

void com.hyphenate.chat.EMChatManager.setMessageListened ( EMMessage message )

将消息设置为已听。一般用于语音消息。

参数

message 要设置的消息对象。

弃用:: 请使用 EMChatManager#setVoiceMessageListened(EMMessage) 替代。

◆ setVoiceMessageListened()

void com.hyphenate.chat.EMChatManager.setVoiceMessageListened ( EMMessage message )

将消息设置为已听。一般用于语音消息。

参数

message 要设置的消息对象。

◆ translateMessage()

void com.hyphenate.chat.EMChatManager.translateMessage	(	EMMessage	message,
		List< String >	languages,
		EMValueCallBack< EMMessage >	callBack
	)

翻译消息

参数

message	消息对象
languages	要翻译的目标语言code列表
callBack	完成回调

◆ updateMessage()

boolean com.hyphenate.chat.EMChatManager.updateMessage ( EMMessage message )

更新本地消息。

会更新本地内存和数据库。

参数

message 要更新的消息对象。

◆ updateParticipant()

boolean com.hyphenate.chat.EMChatManager.updateParticipant	(	String	from,
		String	changeTo
	)

将数据库中的某个联系人相关信息变更成另外一个联系人。

与变更相关的表单包含消息表单，会话表单，联系人表单，黑名单表单。

注意：该操作不会更新内存中数据。

参数

from	更换前的用户 ID。
changeTo	更换后的用户 ID。

返回: 返回更新结果，任何表单更新失败，都会返回 false。

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

hyphenatechatsdk/src/com/hyphenate/chat/EMChatManager.java

Public 成员函数

Protected 成员函数

详细描述

成员函数说明

◆ ackConversationRead()

◆ ackGroupMessageRead()

◆ ackMessageRead()

◆ addConversationListener()

◆ addMessageListener()

◆ addReaction()

◆ asyncAddReaction()

◆ asyncFetchConversationsFromServer()

◆ asyncFetchGroupReadAcks()

◆ asyncFetchHistoryMessage() [1/2]

◆ asyncFetchHistoryMessage() [2/2]

◆ asyncGetReactionDetail()

◆ asyncGetReactionList()

◆ asyncRemoveReaction()

◆ asyncReportMessage()

◆ aysncRecallMessage()

◆ deleteConversation()

◆ deleteConversationFromServer()

◆ deleteMessagesBeforeTimestamp()

◆ downloadAttachment()

◆ downloadFile()

◆ downloadThumbnail()

◆ fetchConversationsFromServer()

◆ fetchGroupReadAcks()

◆ fetchHistoryMessages() [1/2]

◆ fetchHistoryMessages() [2/2]

◆ fetchSupportLanguages()

◆ getAllConversations()

◆ getConversation() [1/4]

◆ getConversation() [2/4]

◆ getConversation() [3/4]

◆ getConversation() [4/4]

◆ getConversationsByType()

◆ getMessage()

◆ getReactionDetail()

◆ getReactionList()

◆ getUnreadMessageCount()

◆ getUnreadMsgsCount()

◆ importMessages()

◆ loadAllConversations()

◆ markAllConversationsAsRead()

◆ recallMessage()

◆ removeConversationListener()

◆ removeMessageListener()

◆ removeReaction()

◆ reportMessage()

◆ saveMessage()

◆ searchMsgFromDB() [1/2]

◆ searchMsgFromDB() [2/2]

◆ sendMessage()

◆ setMessageListened()

◆ setVoiceMessageListened()

◆ translateMessage()

◆ updateMessage()

◆ updateParticipant()