Public 成员函数 | |
void | addChatThreadChangeListener (EMChatThreadChangeListener listener) |
void | removeChatThreadChangeListener (EMChatThreadChangeListener listener) |
void | createChatThread (String parentId, String messageId, String chatThreadName, EMValueCallBack< EMChatThread > callBack) |
void | getChatThreadFromServer (String chatThreadId, EMValueCallBack< EMChatThread > callBack) |
void | joinChatThread (String chatThreadId, EMValueCallBack< EMChatThread > callBack) |
void | destroyChatThread (String chatThreadId, EMCallBack callBack) |
void | leaveChatThread (String chatThreadId, EMCallBack callBack) |
void | updateChatThreadName (String chatThreadId, String chatThreadName, EMCallBack callBack) |
void | removeMemberFromChatThread (String chatThreadId, String member, EMCallBack callBack) |
void | getChatThreadMembers (String chatThreadId, int limit, String cursor, EMValueCallBack< EMCursorResult< String > > callBack) |
void | getJoinedChatThreadsFromServer (int limit, String cursor, EMValueCallBack< EMCursorResult< EMChatThread > > callBack) |
void | getJoinedChatThreadsFromServer (String parentId, int limit, String cursor, EMValueCallBack< EMCursorResult< EMChatThread > > callBack) |
void | getChatThreadsFromServer (String parentId, int limit, String cursor, EMValueCallBack< EMCursorResult< EMChatThread > > callBack) |
void | getChatThreadLatestMessage (List< String > chatThreadIds, EMValueCallBack< Map< String, EMMessage > > callBack) |
子区管理类,用于管理子区,包含子区创建和解散以及成员管理等操作。
void com.hyphenate.chat.EMChatThreadManager.addChatThreadChangeListener | ( | EMChatThreadChangeListener | listener | ) |
注册子区事件监听器,用于监听子区变化,如子区的创建和解散等。
你可以调用 removeChatThreadChangeListener(EMChatThreadChangeListener)
移除不需要的监听器。
listener | 要注册的子区事件监听器。 |
void com.hyphenate.chat.EMChatThreadManager.createChatThread | ( | String | parentId, |
String | messageId, | ||
String | chatThreadName, | ||
EMValueCallBack< EMChatThread > | callBack ) |
创建子区。
子区所属群组的所有成员均可调用该方法。
子区创建成功后,会出现如下情况:
EMChatThreadChangeListener#onChatThreadCreated(EMChatThreadEvent)
。 你可通过设置 EMChatThreadChangeListener
监听相关事件。com.hyphenate.EMMultiDeviceListener#onChatThreadEvent(int, String, List)
。 该回调方法中第一个参数表示子区事件,例如,子区创建事件为 com.hyphenate.EMMultiDeviceListener#THREAD_CREATE
。 你可通过设置 com.hyphenate.EMMultiDeviceListener
监听相关事件。parentId | 父 ID,即群组 ID。 |
messageId | 父消息 ID。 |
chatThreadName | 要创建的子区的名称。长度不超过 64 个字符。 |
callBack | 结果回调:
|
void com.hyphenate.chat.EMChatThreadManager.destroyChatThread | ( | String | chatThreadId, |
EMCallBack | callBack ) |
解散子区。
只有子区所属群组的群主及管理员可调用该方法。
EMChatThreadChangeListener#onChatThreadDestroyed(EMChatThreadEvent)
回调。 你可通过设置 EMChatThreadChangeListener
监听子区事件。com.hyphenate.EMMultiDeviceListener#onChatThreadEvent(int, String, List)
回调。 该回调方法中,第一个参数为子区事件,例如,子区解散事件为 com.hyphenate.EMMultiDeviceListener#THREAD_DESTROY
。 你可通过设置 com.hyphenate.EMMultiDeviceListener
监听子区事件。chatThreadId | 子区 ID。 |
callBack | 结果回调:
|
void com.hyphenate.chat.EMChatThreadManager.getChatThreadFromServer | ( | String | chatThreadId, |
EMValueCallBack< EMChatThread > | callBack ) |
从服务器获取子区详情。
chatThreadId | 子区 ID。 |
callBack | 结果回调:
|
void com.hyphenate.chat.EMChatThreadManager.getChatThreadLatestMessage | ( | List< String > | chatThreadIds, |
EMValueCallBack< Map< String, EMMessage > > | callBack ) |
从服务器批量获取指定子区中的最新一条消息。
chatThreadIds | 要查询的子区 ID 列表,每次最多可传 20 个子区。 |
callBack | 结果回调:
|
EMValueCallBack#onError(int, String)
,返回错误信息。 void com.hyphenate.chat.EMChatThreadManager.getChatThreadMembers | ( | String | chatThreadId, |
int | limit, | ||
String | cursor, | ||
EMValueCallBack< EMCursorResult< String > > | callBack ) |
分页获取子区成员。
子区所属群组的所有成员均可调用该方法。
chatThreadId | 子区 ID。 |
limit | 每页期望返回的成员数。取值范围为 [1,50]。 |
cursor | 开始获取数据的游标位置,首次调用方法时传 null 或空字符串,按成员加入子区时间的正序获取数据。 |
callBack | 结果回调:
|
void com.hyphenate.chat.EMChatThreadManager.getChatThreadsFromServer | ( | String | parentId, |
int | limit, | ||
String | cursor, | ||
EMValueCallBack< EMCursorResult< EMChatThread > > | callBack ) |
分页从服务器端获取指定群组的子区列表。
parentId | 父 ID,即群组 ID。 |
limit | 每页期望返回的子区数。取值范围为 [1,50]。 |
cursor | 开始取数据的游标位置。首次获取数据时传 null 或空字符串,按子区创建时间的倒序获取数据。 |
callBack | 结果回调:
|
void com.hyphenate.chat.EMChatThreadManager.getJoinedChatThreadsFromServer | ( | int | limit, |
String | cursor, | ||
EMValueCallBack< EMCursorResult< EMChatThread > > | callBack ) |
分页从服务器获取当前用户加入的子区列表。
limit | 每页期望返回的子区数。取值范围为 [1,50]。 |
cursor | 开始获取数据的游标位置。首次调用方法时传 null 或空字符串,按用户加入子区时间的倒序获取数据。 |
callBack | 结果回调:
|
void com.hyphenate.chat.EMChatThreadManager.getJoinedChatThreadsFromServer | ( | String | parentId, |
int | limit, | ||
String | cursor, | ||
EMValueCallBack< EMCursorResult< EMChatThread > > | callBack ) |
分页从服务器获取当前用户加入指定群组的子区列表。
parentId | 父 ID,即群组 ID。 |
limit | 每页期望返回的子区数。取值范围为 [1,50]。 |
cursor | 开始取数据的游标位置。首次调用方法时传 null 或空字符串,按用户加入子区时间的倒序获取数据。 |
callBack | 结果回调:
|
EMValueCallBack#onError(int, String)
,返回错误信息。 void com.hyphenate.chat.EMChatThreadManager.joinChatThread | ( | String | chatThreadId, |
EMValueCallBack< EMChatThread > | callBack ) |
加入子区。
子区所属群组的所有成员均可调用该方法。
多端多设备登录时,注意以下几点:
com.hyphenate.EMMultiDeviceListener#onChatThreadEvent(int, String, List)
回调。com.hyphenate.EMMultiDeviceListener#THREAD_JOIN
。com.hyphenate.EMMultiDeviceListener
监听相关事件。chatThreadId | 子区 ID。 |
callBack | 结果回调:
|
void com.hyphenate.chat.EMChatThreadManager.leaveChatThread | ( | String | chatThreadId, |
EMCallBack | callBack ) |
退出子区。
子区中的所有成员均可调用该方法。
多设备登录情况下,注意以下几点:
com.hyphenate.EMMultiDeviceListener#onChatThreadEvent(int, String, List)
回调。com.hyphenate.EMMultiDeviceListener#THREAD_LEAVE
。com.hyphenate.EMMultiDeviceListener
监听相关事件;chatThreadId | 要退出的子区的 ID。 |
callBack | 结果回调:
|
void com.hyphenate.chat.EMChatThreadManager.removeChatThreadChangeListener | ( | EMChatThreadChangeListener | listener | ) |
移除子区事件监听器。
在利用 addChatThreadChangeListener(EMChatThreadChangeListener)
注册子区事件监听器后调用此方法。
listener | 要移除的子区事件监听器。 |
void com.hyphenate.chat.EMChatThreadManager.removeMemberFromChatThread | ( | String | chatThreadId, |
String | member, | ||
EMCallBack | callBack ) |
移除子区成员。
只有子区所属群主、群管理员及子区创建者可调用该方法。
被移出的成员会收到 EMChatThreadChangeListener#onChatThreadUserRemoved(EMChatThreadEvent)
回调。
你可通过设置 EMChatThreadChangeListener
监听子区事件。
chatThreadId | 子区 ID。 |
member | 被移出子区的成员的用户 ID。 |
callBack | 结果回调。
|
void com.hyphenate.chat.EMChatThreadManager.updateChatThreadName | ( | String | chatThreadId, |
String | chatThreadName, | ||
EMCallBack | callBack ) |
修改子区名称。
只有子区所属群主、群管理员及子区创建者可调用该方法。
子区所属群组的成员会收到 EMChatThreadChangeListener#onChatThreadUpdated(EMChatThreadEvent)
回调。
你可通过设置 EMChatThreadChangeListener
监听子区事件。
chatThreadId | 子区 ID。 |
chatThreadName | 子区的新名称。长度不超过 64 个字符。 |
callBack | 结果回调:
|