hyphenate_SDK4.0 4.6.0
hyphenate java IM SDK
| Public 成员函数 | 所有成员列表
com.hyphenate.chat.EMGroupManager类 参考

enum  EMGroupStyle
 

Public 成员函数

List< EMGroupgetAllGroups ()
 
EMGroup getGroup (String groupId)
 
EMGroup createGroup (String groupName, String desc, String[] allMembers, String reason, EMGroupOptions option) throws HyphenateException
 
void asyncCreateGroup (final String groupName, final String desc, final String[] allMembers, final String reason, final EMGroupOptions option, final EMValueCallBack< EMGroup > callback)
 
synchronized void loadAllGroups ()
 
void destroyGroup (final String groupId) throws HyphenateException
 
void asyncDestroyGroup (final String groupId, final EMCallBack callback)
 
void addUsersToGroup (String groupId, String[] newmembers) throws HyphenateException
 
void addUsersToGroup (String groupId, String[] newmembers, String welcomeMessage) throws HyphenateException
 
void asyncAddUsersToGroup (final String groupId, final String[] newmembers, final EMCallBack callback)
 
void removeUserFromGroup (final String groupId, final String username) throws HyphenateException
 
void asyncRemoveUserFromGroup (final String groupId, final String username, final EMCallBack callback)
 
void removeUsersFromGroup (final String groupId, final List< String > members) throws HyphenateException
 
void asyncRemoveUsersFromGroup (final String groupId, final List< String > members, final EMCallBack callback)
 
void leaveGroup (String groupId) throws HyphenateException
 
void asyncLeaveGroup (final String groupId, final EMCallBack callback)
 
EMGroup getGroupFromServer (String groupId) throws HyphenateException
 
EMGroup getGroupFromServer (String groupId, boolean fetchMembers) throws HyphenateException
 
void asyncGetGroupFromServer (final String groupId, final EMValueCallBack< EMGroup > callback)
 
synchronized List< EMGroupgetJoinedGroupsFromServer () throws HyphenateException
 
synchronized List< EMGroupgetJoinedGroupsFromServer (int pageIndex, int pageSize) throws HyphenateException
 
synchronized List< EMGroupgetJoinedGroupsFromServer (int pageIndex, int pageSize, boolean needMemberCount, boolean needRole) throws HyphenateException
 
void asyncGetJoinedGroupsFromServer (final EMValueCallBack< List< EMGroup > > callback)
 
void asyncGetJoinedGroupsFromServer (final int pageIndex, final int pageSize, final EMValueCallBack< List< EMGroup > > callback)
 
void asyncGetJoinedGroupsFromServer (final int pageIndex, final int pageSize, boolean needMemberCount, boolean needRole, final EMValueCallBack< List< EMGroup > > callback)
 
void asyncGetJoinedGroupsCountFromServer (final EMValueCallBack< Integer > callback)
 
EMCursorResult< EMGroupInfogetPublicGroupsFromServer (int pageSize, String cursor) throws HyphenateException
 
void asyncGetPublicGroupsFromServer (final int pageSize, final String cursor, final EMValueCallBack< EMCursorResult< EMGroupInfo > > callback)
 
void joinGroup (String groupId) throws HyphenateException
 
void asyncJoinGroup (final String groupId, final EMCallBack callback)
 
void changeGroupName (String groupId, String changedGroupName) throws HyphenateException
 
void asyncChangeGroupName (final String groupId, final String changedGroupName, final EMCallBack callback)
 
void changeGroupDescription (String groupId, String changedDescription) throws HyphenateException
 
void asyncChangeGroupDescription (final String groupId, final String changedDescription, final EMCallBack callBack)
 
EMGroup acceptInvitation (String groupId, String inviter) throws HyphenateException
 
void asyncAcceptInvitation (final String groupId, final String inviter, final EMValueCallBack< EMGroup > callback)
 
void declineInvitation (String groupId, String inviter, String reason) throws HyphenateException
 
void asyncDeclineInvitation (final String groupId, final String inviter, final String reason, final EMCallBack callback)
 
void acceptApplication (String username, String groupId) throws HyphenateException
 
void asyncAcceptApplication (final String username, final String groupId, final EMCallBack callback)
 
void declineApplication (String username, String groupId, String reason) throws HyphenateException
 
void asyncDeclineApplication (final String username, final String groupId, final String reason, final EMCallBack callback)
 
void inviteUser (String groupId, String[] beInvitedUsernames, String reason) throws HyphenateException
 
void asyncInviteUser (final String groupId, final String[] beInvitedUsernames, final String reason, final EMCallBack callback)
 
void applyJoinToGroup (String groupId, String reason) throws HyphenateException
 
void asyncApplyJoinToGroup (final String groupId, final String reason, final EMCallBack callback)
 
void blockGroupMessage (String groupId) throws HyphenateException
 
void asyncBlockGroupMessage (final String groupId, final EMCallBack callback)
 
void unblockGroupMessage (String groupId) throws HyphenateException
 
void asyncUnblockGroupMessage (final String groupId, final EMCallBack callback)
 
void blockUser (String groupId, String username) throws HyphenateException
 
void asyncBlockUser (final String groupId, final String username, final EMCallBack callback)
 
void blockUsers (String groupId, List< String > members) throws HyphenateException
 
void asyncBlockUsers (final String groupId, final List< String > members, final EMCallBack callback)
 
void unblockUser (String groupId, String username) throws HyphenateException
 
void asyncUnblockUser (final String groupId, final String username, final EMCallBack callback)
 
void unblockUsers (String groupId, List< String > members) throws HyphenateException
 
void asyncUnblockUsers (final String groupId, final List< String > members, final EMCallBack callback)
 
List< String > getBlockedUsers (String groupId) throws HyphenateException
 
List< String > getBlockedUsers (String groupId, int pageIndex, int pageSize) throws HyphenateException
 
void asyncGetBlockedUsers (final String groupId, final EMValueCallBack< List< String > > callback)
 
void asyncGetBlockedUsers (final String groupId, final int pageIndex, final int pageSize, final EMValueCallBack< List< String > > callback)
 
void addGroupChangeListener (EMGroupChangeListener listener)
 
void removeGroupChangeListener (EMGroupChangeListener listener)
 
EMCursorResult< String > fetchGroupMembers (String groupId, String cursor, int pageSize) throws HyphenateException
 
void asyncFetchGroupMembers (final String groupId, final String cursor, final int pageSize, final EMValueCallBack< EMCursorResult< String > > callback)
 
EMGroup changeOwner (String groupId, String newOwner) throws HyphenateException
 
void asyncChangeOwner (final String groupId, final String newOwner, final EMValueCallBack< EMGroup > callback)
 
EMGroup addGroupAdmin (final String groupId, final String admin) throws HyphenateException
 
void asyncAddGroupAdmin (final String groupId, final String admin, final EMValueCallBack< EMGroup > callback)
 
EMGroup removeGroupAdmin (String groupId, String admin) throws HyphenateException
 
void asyncRemoveGroupAdmin (final String groupId, final String admin, final EMValueCallBack< EMGroup > callback)
 
EMGroup muteGroupMembers (String groupId, List< String > muteMembers, long duration) throws HyphenateException
 
void asyncMuteGroupMembers (final String groupId, final List< String > muteMembers, final long duration, final EMValueCallBack< EMGroup > callback)
 
EMGroup unMuteGroupMembers (String groupId, List< String > members) throws HyphenateException
 
void asyncUnMuteGroupMembers (final String groupId, final List< String > members, final EMValueCallBack< EMGroup > callback)
 
Map< String, Long > fetchGroupMuteList (String groupId, int pageNum, int pageSize) throws HyphenateException
 
void asyncFetchGroupMuteList (final String groupId, final int pageNum, final int pageSize, final EMValueCallBack< Map< String, Long > > callBack)
 
List< String > fetchGroupBlackList (String groupId, int pageNum, int pageSize) throws HyphenateException
 
void asyncFetchGroupBlackList (final String groupId, final int pageNum, final int pageSize, final EMValueCallBack< List< String > > callBack)
 
void addToGroupWhiteList (final String groupId, final List< String > members, final EMCallBack callBack)
 
void removeFromGroupWhiteList (final String groupId, final List< String > members, final EMCallBack callBack)
 
void checkIfInGroupWhiteList (final String groupId, EMValueCallBack< Boolean > callBack)
 
void fetchGroupWhiteList (final String groupId, final EMValueCallBack< List< String > > callBack)
 
void muteAllMembers (final String groupId, final EMValueCallBack< EMGroup > callBack)
 
void unmuteAllMembers (final String groupId, final EMValueCallBack< EMGroup > callBack)
 
void updateGroupAnnouncement (String groupId, String announcement) throws HyphenateException
 
void asyncUpdateGroupAnnouncement (final String groupId, final String announcement, final EMCallBack callBack)
 
String fetchGroupAnnouncement (String groupId) throws HyphenateException
 
void asyncFetchGroupAnnouncement (final String groupId, final EMValueCallBack< String > callBack)
 
EMMucSharedFile uploadGroupSharedFile (String groupId, String filePath, EMCallBack callBack) throws HyphenateException
 
void asyncUploadGroupSharedFile (final String groupId, final String filePath, final EMCallBack callBack)
 
void asyncUploadGroupSharedFile (final String groupId, final String filePath, final EMValueCallBack< EMMucSharedFile > callBack)
 
List< EMMucSharedFilefetchGroupSharedFileList (String groupId, int pageNum, int pageSize) throws HyphenateException
 
void asyncFetchGroupSharedFileList (final String groupId, final int pageNum, final int pageSize, final EMValueCallBack< List< EMMucSharedFile > > callBack)
 
void deleteGroupSharedFile (String groupId, String fileId) throws HyphenateException
 
void asyncDeleteGroupSharedFile (final String groupId, final String fileId, final EMCallBack callBack)
 
void downloadGroupSharedFile (String groupId, String fileId, String savePath, EMCallBack callBack) throws HyphenateException
 
void asyncDownloadGroupSharedFile (final String groupId, final String fileId, final String savePath, final EMCallBack callBack)
 
void asyncSetGroupMemberAttributes (String groupId, String userId, Map< String, String > attributeMap, EMCallBack callBack)
 
void asyncFetchGroupMemberAllAttributes (String groupId, String userId, EMValueCallBack< Map< String, Map< String, String > > > callBack)
 
void asyncFetchGroupMembersAttributes (String groupId, List< String > userList, List< String > keyList, EMValueCallBack< Map< String, Map< String, String > > > callBack)
 
EMGroup updateGroupExtension (String groupId, String extension) throws HyphenateException
 

详细描述

群组管理, 用于管理群组的创建,删除,成员管理等操作。

成员函数说明

◆ acceptApplication()

void com.hyphenate.chat.EMGroupManager.acceptApplication ( String  username,
String  groupId 
) throws HyphenateException

批准入群申请。 仅群主和管理员可调用此方法。 异步方法见 asyncAcceptApplication(String, String, EMCallBack)

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

参数
username申请人 ID。
groupId群组 ID。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ acceptInvitation()

EMGroup com.hyphenate.chat.EMGroupManager.acceptInvitation ( String  groupId,
String  inviter 
) throws HyphenateException

接受入群邀请。 异步方法见 asyncAcceptInvitation(String, String, EMValueCallBack)

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

参数
groupId群组 ID。
inviter邀请者 ID。
返回
用户已经同意邀请的群组对象。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ addGroupAdmin()

EMGroup com.hyphenate.chat.EMGroupManager.addGroupAdmin ( final String  groupId,
final String  admin 
) throws HyphenateException

添加群组管理员。 仅群主可调用此方法,admin 无权限。 异步方法见 asyncAddGroupAdmin(String, String, EMValueCallBack)

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

参数
groupId群组 ID。
admin新增的管理员 ID。
返回
返回更新后的群组对象。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ addGroupChangeListener()

void com.hyphenate.chat.EMGroupManager.addGroupChangeListener ( EMGroupChangeListener  listener)

注册群变动事件监听。 注册后,需要配合 removeGroupChangeListener(EMGroupChangeListener) 使用。

参数
listener注册的群组事件监听。

◆ addToGroupWhiteList()

void com.hyphenate.chat.EMGroupManager.addToGroupWhiteList ( final String  groupId,
final List< String >  members,
final EMCallBack  callBack 
)

添加白名单。 仅群组创建者和管理员可调用此方法。

异步方法。

参数
groupId群组 ID。
members要添加的成员列表。
callBack结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ addUsersToGroup() [1/2]

void com.hyphenate.chat.EMGroupManager.addUsersToGroup ( String  groupId,
String[]  newmembers 
) throws HyphenateException

向群组中添加新成员。 仅群组创建者和管理员可调用此方法。 异步方法见 asyncAddUsersToGroup(String, String[], EMCallBack)

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

参数
groupId群组 ID。
newmembers要添加的新成员数组。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ addUsersToGroup() [2/2]

void com.hyphenate.chat.EMGroupManager.addUsersToGroup ( String  groupId,
String[]  newmembers,
String  welcomeMessage 
) throws HyphenateException

向群组中添加新成员。 仅群主和管理员可调用此方法。 异步方法见 asyncAddUsersToGroup(String, String[], EMCallBack)

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

参数
groupId群组 ID。
newmembers要添加的新成员数组。
welcomeMessage邀请信息。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ applyJoinToGroup()

void com.hyphenate.chat.EMGroupManager.applyJoinToGroup ( String  groupId,
String  reason 
) throws HyphenateException

申请加入群组。 前提:群组类型为 EMGroupStyle#EMGroupStylePublicJoinNeedApproval,即需要验证的公开群组。 异步方法见 asyncApplyJoinToGroup(String, String, EMCallBack)

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

参数
groupId群组ID。
reason申请加入的原因。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ asyncAcceptApplication()

void com.hyphenate.chat.EMGroupManager.asyncAcceptApplication ( final String  username,
final String  groupId,
final EMCallBack  callback 
)

批准入群申请。 仅群主和管理员可调用此方法。 同步方法见 acceptApplication(String, String)

异步方法。

参数
username申请人 ID。
groupId群组 ID。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncAcceptInvitation()

void com.hyphenate.chat.EMGroupManager.asyncAcceptInvitation ( final String  groupId,
final String  inviter,
final EMValueCallBack< EMGroup callback 
)

接受入群邀请。 同步方法见 acceptInvitation(String, String)

异步方法。

参数
groupId群组 ID。
inviter邀请者 ID。
callback结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回更新后的群组对象; 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncAddGroupAdmin()

void com.hyphenate.chat.EMGroupManager.asyncAddGroupAdmin ( final String  groupId,
final String  admin,
final EMValueCallBack< EMGroup callback 
)

添加群组管理员。 仅群主可调用此方法,admin 无权限。 同步方法见 addGroupAdmin(String, String)

异步方法。

参数
groupId群组 ID。
admin新增加的管理员 ID。
callback结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回更新后的群组对象; 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncAddUsersToGroup()

void com.hyphenate.chat.EMGroupManager.asyncAddUsersToGroup ( final String  groupId,
final String[]  newmembers,
final EMCallBack  callback 
)

向群组中添加新成员。 仅群主和管理员可调用此方法。 同步方法见 addUsersToGroup(String, String[])

异步方法。

参数
groupId群组的 ID。
newmembers要添加的新成员数组。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncApplyJoinToGroup()

void com.hyphenate.chat.EMGroupManager.asyncApplyJoinToGroup ( final String  groupId,
final String  reason,
final EMCallBack  callback 
)

申请加入群组。 前提:群组类型为 EMGroupStyle#EMGroupStylePublicJoinNeedApproval,即需要需要验证的公开群。 同步方法见 applyJoinToGroup(String, String)

异步方法。

参数
groupId群组 ID。
reason申请加入的原因。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncBlockGroupMessage()

void com.hyphenate.chat.EMGroupManager.asyncBlockGroupMessage ( final String  groupId,
final EMCallBack  callback 
)

屏蔽群消息。 被屏蔽群消息的用户仍是群成员,但无法接收群消息。 同步方法见 blockGroupMessage(String)

异步方法。

参数
groupId群组 ID。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncBlockUser()

void com.hyphenate.chat.EMGroupManager.asyncBlockUser ( final String  groupId,
final String  username,
final EMCallBack  callback 
)

将用户加入群组黑名单。 先将用户移出群,再加入黑名单。加入黑名单的用户无法加入群。 仅群主和管理员可调用此方法。 同步方法见 blockUser(String, String)

异步方法。

参数
groupId群组 ID。
username要加入黑名单的用户名。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncBlockUsers()

void com.hyphenate.chat.EMGroupManager.asyncBlockUsers ( final String  groupId,
final List< String >  members,
final EMCallBack  callback 
)

将用户加入群组黑名单。 先将用户移出群,再加入黑名单。加入黑名单的用户无法加入群。 仅群主和管理员可调用此方法。 同步方法见 blockUsers(String, List)

异步方法。

参数
groupId群组ID。
members要加入黑名单的用户列表。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncChangeGroupDescription()

void com.hyphenate.chat.EMGroupManager.asyncChangeGroupDescription ( final String  groupId,
final String  changedDescription,
final EMCallBack  callBack 
)

修改群描述。 仅群主和管理员可调用此方法。 同步方法见 changeGroupDescription(String, String)

异步方法。

参数
groupId群组 ID。
changedDescription修改后的群描述。
callBack结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncChangeGroupName()

void com.hyphenate.chat.EMGroupManager.asyncChangeGroupName ( final String  groupId,
final String  changedGroupName,
final EMCallBack  callback 
)

修改群组名称。 仅群主和管理员可调用此方法。 同步方法见 changeGroupName(String, String)

异步方法。

参数
groupId需要修改名称的群组的 ID。
changedGroupName修改后的群组名称。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncChangeOwner()

void com.hyphenate.chat.EMGroupManager.asyncChangeOwner ( final String  groupId,
final String  newOwner,
final EMValueCallBack< EMGroup callback 
)

移交群组所有权。 仅群主可调用此方法。 同步方法见 changeOwner(String, String)

异步方法。

参数
groupId群组 ID。
newOwner新的群主。
callback结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回更新后的群组对象; 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncCreateGroup()

void com.hyphenate.chat.EMGroupManager.asyncCreateGroup ( final String  groupName,
final String  desc,
final String[]  allMembers,
final String  reason,
final EMGroupOptions  option,
final EMValueCallBack< EMGroup callback 
)

创建群组。 群组创建成功后,会更新内存及数据库中的数据,多端多设备会收到相应的通知事件,然后将群组更新到内存及数据库中。 可通过设置 com.hyphenate.EMMultiDeviceListener 监听相关事件,事件回调函数为 com.hyphenate.EMMultiDeviceListener#onGroupEvent(int, String, List), 第一个参数为事件,建群事件为 com.hyphenate.EMMultiDeviceListener#GROUP_CREATE

异步方法。

参数
groupName群组的名字,非必要,不设置传 null。
desc群组描述,非必要,不设置传 null。
allMembers群成员数组。群主 ID非必要。该参数不可为 null。
reason成员入群的邀请信息,非必要,不设置传 null。
option群组设置,非必要,不可为 null。详见 EMGroupOptions。 群组的其他选项如下:
callback结果回调,成功时回调 EMValueCallBack#onSuccess(Object),返回创建成功的群组对象; 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncDeclineApplication()

void com.hyphenate.chat.EMGroupManager.asyncDeclineApplication ( final String  username,
final String  groupId,
final String  reason,
final EMCallBack  callback 
)

拒绝入群申请。 仅群组创建者和管理员可调用此方法。 同步方法见 declineApplication(String, String, String)

异步方法。

参数
username申请人 ID。
groupId群组 ID。
reason拒绝理由。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncDeclineInvitation()

void com.hyphenate.chat.EMGroupManager.asyncDeclineInvitation ( final String  groupId,
final String  inviter,
final String  reason,
final EMCallBack  callback 
)

拒绝入群邀请。 同步方法见 declineInvitation(String, String, String)

异步方法。

参数
groupId群组 ID。
inviter邀请人 ID。
reason拒绝理由。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncDeleteGroupSharedFile()

void com.hyphenate.chat.EMGroupManager.asyncDeleteGroupSharedFile ( final String  groupId,
final String  fileId,
final EMCallBack  callBack 
)

删除群组指定的共享文件。 成员可以删除自己上传的文件,群组拥有者或者群组管理员可以删除所有的共享文件。 同步方法见 deleteGroupSharedFile(String, String)

异步方法。

参数
groupId群组 ID。
fileId文件 ID。
callBack结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncDestroyGroup()

void com.hyphenate.chat.EMGroupManager.asyncDestroyGroup ( final String  groupId,
final EMCallBack  callback 
)

解散群组。 仅群主可调用此方法。 同步方法见 destroyGroup(String)

异步方法。

参数
groupId群组 ID。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncDownloadGroupSharedFile()

void com.hyphenate.chat.EMGroupManager.asyncDownloadGroupSharedFile ( final String  groupId,
final String  fileId,
final String  savePath,
final EMCallBack  callBack 
)

下载群组中指定的共享文件。 同步方法见 downloadGroupSharedFile(String, String, String, EMCallBack)

异步方法。

参数
groupId群组 ID。
fileId共享文件 ID。
savePath文件保存路径。
callBack结果回调,成功时回调 EMCallBack#onSuccess(), 下载文件进度回调 EMCallBack#onProgress(int, String), 失败时回调 EMCallBack#onError(int, String)

◆ asyncFetchGroupAnnouncement()

void com.hyphenate.chat.EMGroupManager.asyncFetchGroupAnnouncement ( final String  groupId,
final EMValueCallBack< String >  callBack 
)

从服务器获取群公告。 群成员可调用此方法。 同步方法见 fetchGroupAnnouncement(String)

异步方法。

参数
groupId群组 ID。
callBack结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncFetchGroupBlackList()

void com.hyphenate.chat.EMGroupManager.asyncFetchGroupBlackList ( final String  groupId,
final int  pageNum,
final int  pageSize,
final EMValueCallBack< List< String > >  callBack 
)

以分页从服务器获群组黑名单。 仅群主和管理员可调用此方法。 同步方法见 fetchGroupBlackList(String, int, int)

异步方法。

参数
groupId群组 ID。
pageNum当前页码,从 1 开始。
pageSize每页返回的黑名单上的用户数。
callBack结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回分页获取的黑名单列表; 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncFetchGroupMemberAllAttributes()

void com.hyphenate.chat.EMGroupManager.asyncFetchGroupMemberAllAttributes ( String  groupId,
String  userId,
EMValueCallBack< Map< String, Map< String, String > > >  callBack 
)

获取单个群成员所有自定义属性。

参数
groupId群组 ID。
userId要获取的自定义属性的群成员的用户 ID。
callBack结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncFetchGroupMembers()

void com.hyphenate.chat.EMGroupManager.asyncFetchGroupMembers ( final String  groupId,
final String  cursor,
final int  pageSize,
final EMValueCallBack< EMCursorResult< String > >  callback 
)

以分页方式获取群组成员列表。 同步方法见 fetchGroupMembers(String, String, int)

异步方法。

参数
groupId群组 ID。
cursor从这个游标位置开始取数据,首次获取数据时传 null 即可。
pageSize每页返回的群组成员数。
callback结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回分页获取结果 EMCursorResult,包含用于下次获取数据的 cursor 以及群组成员集合的对象, 如果是最后一页,cursor 返回结果为空字符串; 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncFetchGroupMembersAttributes()

void com.hyphenate.chat.EMGroupManager.asyncFetchGroupMembersAttributes ( String  groupId,
List< String >  userList,
List< String >  keyList,
EMValueCallBack< Map< String, Map< String, String > > >  callBack 
)

根据指定的属性 key 获取多个群成员的自定义属性。

参数
groupId群组 ID。
userList要获取自定义属性的群成员的用户 ID 数组。
keyList要获取自定义属性的 key 的数组。若 keys 为空数组或不传则获取这些群成员的所有自定义属性。
callBack结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncFetchGroupMuteList()

void com.hyphenate.chat.EMGroupManager.asyncFetchGroupMuteList ( final String  groupId,
final int  pageNum,
final int  pageSize,
final EMValueCallBack< Map< String, Long > >  callBack 
)

获取群组的禁言列表。 仅群主和管理员可调用此方法。 同步方法见 fetchGroupMuteList(String, int, int)

异步方法。

参数
groupId群组 ID。
pageNum当前页码,从 1 开始。
pageSize每页返回的禁言成员数。
callBack结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回的包含禁言成员 ID 及其禁言时长的 Map,其中每一项的 key 是禁言的成员 ID,value 是禁言时长,单位是毫秒; 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncFetchGroupSharedFileList()

void com.hyphenate.chat.EMGroupManager.asyncFetchGroupSharedFileList ( final String  groupId,
final int  pageNum,
final int  pageSize,
final EMValueCallBack< List< EMMucSharedFile > >  callBack 
)

从服务器获取群共享文件列表。 同步方法见 fetchGroupSharedFileList(String, int, int)

异步方法。

参数
groupId群组 ID。
pageNum当前页码,从 1 开始。
pageSize每页返回的共享文件数。
callBack结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回共享文件列表; 失败时回调 EMValueCallBack#onError(int, String)

需注意以下两点:

  • pageSize 是这次调用期望返回的记录数,如当前在最后一页,返回的数量小于 pageSize 的值;
  • pageNum 是当前页码,方便服务器分页查询返回。 对于数据量未知且很大的情况,分页获取,服务器会根据每次的 pageSize 和 pageNum 的设置返回数据。

◆ asyncGetBlockedUsers() [1/2]

void com.hyphenate.chat.EMGroupManager.asyncGetBlockedUsers ( final String  groupId,
final EMValueCallBack< List< String > >  callback 
)

获取群组的黑名单列表, 默认最多取 200 个。 仅群主和管理员可调用此方法。 同步方法见 getBlockedUsers(String)

异步方法。

参数
groupId群组 ID。
callback结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回群组的黑名单列表; 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncGetBlockedUsers() [2/2]

void com.hyphenate.chat.EMGroupManager.asyncGetBlockedUsers ( final String  groupId,
final int  pageIndex,
final int  pageSize,
final EMValueCallBack< List< String > >  callback 
)

以分页方式获取群组的黑名单。 仅群主和管理员可调用此方法。 同步方法见 getBlockedUsers(String, int, int)

异步方法。

参数
groupId群组 ID。
pageIndex当前页码,从 1 开始。
pageSize每页返回的群组数。
callback结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回黑名单列表; 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncGetGroupFromServer()

void com.hyphenate.chat.EMGroupManager.asyncGetGroupFromServer ( final String  groupId,
final EMValueCallBack< EMGroup callback 
)

从服务器获取群组的详细信息。 同步方法见 getGroupFromServer(String)

异步方法。

参数
groupId群组 ID。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncGetJoinedGroupsCountFromServer()

void com.hyphenate.chat.EMGroupManager.asyncGetJoinedGroupsCountFromServer ( final EMValueCallBack< Integer >  callback)

从服务器获取当前用户已加入的群组数量。

异步方法。

参数
callback结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回获取的群组数量 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncGetJoinedGroupsFromServer() [1/3]

void com.hyphenate.chat.EMGroupManager.asyncGetJoinedGroupsFromServer ( final EMValueCallBack< List< EMGroup > >  callback)

从服务器获取当前用户的所有群组。

此操作只返回群组列表,并不获取群组的所有成员信息。如果要更新某个群组包括成员的全部信息,需要再调用 getGroupFromServer(String groupId)

同步方法见 getJoinedGroupsFromServer()

异步方法。

参数
callback结果回调,成功时回调 EMValueCallBack#onSuccess(Object),返回已加入的群组列表 失败时回调 EMValueCallBack#onError(int, String)
弃用:
已废弃,请使用 asyncGetJoinedGroupsFromServer(int, int, boolean, boolean, EMValueCallBack) 代替。

◆ asyncGetJoinedGroupsFromServer() [2/3]

void com.hyphenate.chat.EMGroupManager.asyncGetJoinedGroupsFromServer ( final int  pageIndex,
final int  pageSize,
boolean  needMemberCount,
boolean  needRole,
final EMValueCallBack< List< EMGroup > >  callback 
)

以分页方式从服务器获取当前用户已加入的群组。 此操作只返回群组列表,不包含群组的所有成员信息。如果要更新某个群组包括成员的全部信息,需要再调用 getGroupFromServer(String groupId)。 同步方法见 getJoinedGroupsFromServer(int, int, boolean, boolean)

异步方法。

参数
pageIndex当前页码,从 0 开始。
pageSize每页返回的群组数。pageSize 最大不超过 20
needMemberCount是否需要群成员人数。
needRole是否需要用户在群里的角色。
callback结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回分页获取的群组列表 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncGetJoinedGroupsFromServer() [3/3]

void com.hyphenate.chat.EMGroupManager.asyncGetJoinedGroupsFromServer ( final int  pageIndex,
final int  pageSize,
final EMValueCallBack< List< EMGroup > >  callback 
)

以分页方式从服务器获取当前用户已加入的群组。 此操作只返回群组列表,不包含群组的所有成员信息。如果要更新某个群组包括成员的全部信息,需要再调用 getGroupFromServer(String groupId)。 同步方法见 getJoinedGroupsFromServer(int, int)

异步方法。

参数
pageIndex当前页码,从 1 开始。
pageSize每页返回的群组数。
callback结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回分页获取的群组列表 失败时回调 EMValueCallBack#onError(int, String)
弃用:
已废弃,请使用 asyncGetJoinedGroupsFromServer(int, int, boolean, boolean, EMValueCallBack) 替代.

◆ asyncGetPublicGroupsFromServer()

void com.hyphenate.chat.EMGroupManager.asyncGetPublicGroupsFromServer ( final int  pageSize,
final String  cursor,
final EMValueCallBack< EMCursorResult< EMGroupInfo > >  callback 
)

以分页方式从服务器获取公开群组。 同步方法见 getPublicGroupsFromServer(int, String)

异步方法。

参数
pageSize每页返回的公开群组数。
cursor从这个游标位置开始取数据,首次获取数据时传 null 即可。
callback结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回分页获取结果 EMCursorResult,包含用于下次获取数据的 cursor 以及群组list的对象。 如果是最后一页,cursor 返回结果为空字符串; 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncInviteUser()

void com.hyphenate.chat.EMGroupManager.asyncInviteUser ( final String  groupId,
final String[]  beInvitedUsernames,
final String  reason,
final EMCallBack  callback 
)

群成员邀请用户入群。 前提:群组类型是 EMGroupStyle#EMGroupStylePrivateMemberCanInvite,即允许群成员邀请用户。 同步方法见 inviteUser(String, String[], String)

异步方法。

参数
groupId群组 ID。
beInvitedUsernames受邀用户的数组。
reason邀请原因。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncJoinGroup()

void com.hyphenate.chat.EMGroupManager.asyncJoinGroup ( final String  groupId,
final EMCallBack  callback 
)

当前登录用户加入公开群。 如果是自由加入的公开群,直接进入群组;需要验证的公开群需要等待群主同意。详见 EMGroupStyle。 同步方法见 joinGroup(String)

异步方法。

参数
groupId群组 ID。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncLeaveGroup()

void com.hyphenate.chat.EMGroupManager.asyncLeaveGroup ( final String  groupId,
final EMCallBack  callback 
)

当前登录用户退出群组。

异步方法。

参数
groupId群组 ID。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncMuteGroupMembers()

void com.hyphenate.chat.EMGroupManager.asyncMuteGroupMembers ( final String  groupId,
final List< String >  muteMembers,
final long  duration,
final EMValueCallBack< EMGroup callback 
)

将一组成员禁言。 仅群主和管理员可调用此方法。 同步方法见 muteGroupMembers(String, List, long)

异步方法。

参数
groupId群组 ID。
muteMembers要禁言的用户列表。
duration禁言时间,单位是毫秒。若为 -1,表示永久禁言。
callback结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回更新后的群组对象; 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncRemoveGroupAdmin()

void com.hyphenate.chat.EMGroupManager.asyncRemoveGroupAdmin ( final String  groupId,
final String  admin,
final EMValueCallBack< EMGroup callback 
)

删除群组管理员。 仅群主可调用此方法。 同步方法见 removeGroupAdmin(String, String)

异步方法。

参数
groupId群组 ID。
admin删除的管理员 ID。
callback结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回更新后的群组对象; 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncRemoveUserFromGroup()

void com.hyphenate.chat.EMGroupManager.asyncRemoveUserFromGroup ( final String  groupId,
final String  username,
final EMCallBack  callback 
)

将群成员移出群组。 仅群主和管理员可调用此方法。 同步方法见 removeUserFromGroup(String, String)

异步方法。

参数
groupId群组 ID。
username要删除成员的用户名。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncRemoveUsersFromGroup()

void com.hyphenate.chat.EMGroupManager.asyncRemoveUsersFromGroup ( final String  groupId,
final List< String >  members,
final EMCallBack  callback 
)

从群组中删除成员。 仅群主和管理员可调用此方法。 同步方法见 removeUsersFromGroup(String, List)

异步方法。

参数
groupId群组 ID。
members要删除成员的用户名列表。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 败时回调 EMCallBack#onError(int, String)

◆ asyncSetGroupMemberAttributes()

void com.hyphenate.chat.EMGroupManager.asyncSetGroupMemberAttributes ( String  groupId,
String  userId,
Map< String, String >  attributeMap,
EMCallBack  callBack 
)

设置单个群成员的自定义属性。

参数
groupId群组 ID。
userId要设置自定义属性的群成员的用户 ID。
attributeMap要设置的群成员自定义属性的 map,为 key-value 格式。对于一个 key-value 键值对,若 value 设置空字符串即删除该自定义属性。
callBack结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncUnblockGroupMessage()

void com.hyphenate.chat.EMGroupManager.asyncUnblockGroupMessage ( final String  groupId,
final EMCallBack  callback 
)

取消屏蔽群消息。 同步方法见 unblockGroupMessage(String)

异步方法。

参数
groupId群组 ID。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncUnblockUser()

void com.hyphenate.chat.EMGroupManager.asyncUnblockUser ( final String  groupId,
final String  username,
final EMCallBack  callback 
)

将用户从群组黑名单移除。 仅群主和管理员可调用此方法。 同步方法见 unblockUser(String, String)

异步方法。

参数
groupId群组 ID。
username要从黑名单中移除的用户。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncUnblockUsers()

void com.hyphenate.chat.EMGroupManager.asyncUnblockUsers ( final String  groupId,
final List< String >  members,
final EMCallBack  callback 
)

将用户从群组黑名单移除。 仅群主和管理员可调用此方法。 同步方法见 unblockUsers(String, List)

异步方法。

参数
groupId群组 ID。
members要从黑名单中移除的用户列表。
callback结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncUnMuteGroupMembers()

void com.hyphenate.chat.EMGroupManager.asyncUnMuteGroupMembers ( final String  groupId,
final List< String >  members,
final EMValueCallBack< EMGroup callback 
)

解除禁言。 仅群主和管理员可调用此方法。 同步方法见 unMuteGroupMembers(String, List)

异步方法。

参数
groupId群组 ID。
members要解除禁言的用户列表。
callback结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回更新后的群组对象; 失败时回调 EMValueCallBack#onError(int, String)

◆ asyncUpdateGroupAnnouncement()

void com.hyphenate.chat.EMGroupManager.asyncUpdateGroupAnnouncement ( final String  groupId,
final String  announcement,
final EMCallBack  callBack 
)

更新群公告。 仅群主和管理员可调用此方法。 同步方法见updateGroupAnnouncement(String, String)

异步方法。

参数
groupId群组 ID。
announcement公告内容。
callBack结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ asyncUploadGroupSharedFile() [1/2]

void com.hyphenate.chat.EMGroupManager.asyncUploadGroupSharedFile ( final String  groupId,
final String  filePath,
final EMCallBack  callBack 
)

上传共享文件至群组。

同步方法见 uploadGroupSharedFile(String, String, EMCallBack)

异步方法。

参数
groupId群组 ID。
filePath文件本地路径。
callBack结果回调,成功时回调 EMCallBack#onSuccess(), 上传文件进度回调 EMCallBack#onProgress(int, String), 失败时回调 EMCallBack#onError(int, String)。 @Deprecated 已废弃,请用 asyncUploadGroupSharedFile(String, String, EMValueCallBack) 替代。

◆ asyncUploadGroupSharedFile() [2/2]

void com.hyphenate.chat.EMGroupManager.asyncUploadGroupSharedFile ( final String  groupId,
final String  filePath,
final EMValueCallBack< EMMucSharedFile callBack 
)

上传共享文件至群组。

同步方法见 uploadGroupSharedFile(String, String, EMCallBack)

异步方法。

参数
groupId群组 ID。
filePath文件本地路径。
callBack结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 上传文件进度回调 EMValueCallBack#onProgress(int, String), 失败时回调 EMValueCallBack#onError(int, String)

◆ blockGroupMessage()

void com.hyphenate.chat.EMGroupManager.blockGroupMessage ( String  groupId) throws HyphenateException

屏蔽群消息。 被屏蔽群消息的用户仍是群成员,但无法接收群消息。 异步方法见 asyncBlockGroupMessage(String, EMCallBack)

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

参数
groupId群组 ID。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ blockUser()

void com.hyphenate.chat.EMGroupManager.blockUser ( String  groupId,
String  username 
) throws HyphenateException

将用户加入群组黑名单。 先将用户移出群,再加入黑名单。加入黑名单的用户无法加入群。 仅群主和管理员可调用此方法。 异步方法见 asyncBlockUser(String, String, EMCallBack)

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

参数
groupId群组 ID。
username要加入黑名单的用户名。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ blockUsers()

void com.hyphenate.chat.EMGroupManager.blockUsers ( String  groupId,
List< String >  members 
) throws HyphenateException

将用户加入群组黑名单。 先将用户移出群,再加入黑名单。加入黑名单的用户无法加入群。 仅群主和管理员可调用此方法。 异步方法见 asyncBlockUsers(String, List, EMCallBack)

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

参数
groupId群组 ID。
members要加入黑名单的用户列表。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ changeGroupDescription()

void com.hyphenate.chat.EMGroupManager.changeGroupDescription ( String  groupId,
String  changedDescription 
) throws HyphenateException

修改群描述。 仅群主和管理员可调用此方法。 异步方法见 asyncChangeGroupDescription(String, String, EMCallBack)

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

参数
groupId群组 ID。
changedDescription修改后的群描述。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ changeGroupName()

void com.hyphenate.chat.EMGroupManager.changeGroupName ( String  groupId,
String  changedGroupName 
) throws HyphenateException

修改群组名称。 仅群主和管理员可调用此方法。 异步方法见 asyncChangeGroupName(String, String, EMCallBack)

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

参数
groupId要修改名称的群组的 ID。
changedGroupName修改后的群组名称。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ changeOwner()

EMGroup com.hyphenate.chat.EMGroupManager.changeOwner ( String  groupId,
String  newOwner 
) throws HyphenateException

移交群组所有权。 仅群主可调用此方法。 异步方法见 asyncChangeOwner(String, String, EMValueCallBack)

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

参数
groupId群组 ID。
newOwner新的群主。
返回
返回更新后的群组对象
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息详见 EMError

◆ checkIfInGroupWhiteList()

void com.hyphenate.chat.EMGroupManager.checkIfInGroupWhiteList ( final String  groupId,
EMValueCallBack< Boolean >  callBack 
)

检查自己是否在群组白名单中。

异步方法。

参数
groupId群组 ID。
callBack结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回是否在群组白名单的布尔值; 失败时回调 EMValueCallBack#onError(int, String)

◆ createGroup()

EMGroup com.hyphenate.chat.EMGroupManager.createGroup ( String  groupName,
String  desc,
String[]  allMembers,
String  reason,
EMGroupOptions  option 
) throws HyphenateException

创建群组。 群组创建成功后,会更新内存及数据库中的数据,多端多设备会收到相应的通知事件,将群组更新到内存及数据库中。 可通过设置 com.hyphenate.EMMultiDeviceListener监听相关事件,事件回调函数为 com.hyphenate.EMMultiDeviceListener#onGroupEvent(int, String, List), 第一个参数为事件,建群事件为 com.hyphenate.EMMultiDeviceListener#GROUP_CREATE。 异步方法见 asyncCreateGroup(String, String, String[], String, EMGroupOptions, EMValueCallBack)

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

参数
groupName群组的名字,非必要,不设置传 null。
desc群组描述,非必要,不设置传 null。
allMembers群成员数组。群主 ID 非必要。该参数不可为 null。
reason邀请群成员加入时的邀请信息,非必要,不设置传 null。
option群的设置,非必要,不可为 null。详见 EMGroupOptions。 群组的其他选项如下:
返回
返回创建成功的群对象。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ declineApplication()

void com.hyphenate.chat.EMGroupManager.declineApplication ( String  username,
String  groupId,
String  reason 
) throws HyphenateException

拒绝入群申请。 仅群组创建者和管理员可调用此方法。 异步方法见 asyncDeclineApplication(String, String, String, EMCallBack)

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

参数
username申请人 ID。
groupId群组 ID。
reason拒绝理由。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ declineInvitation()

void com.hyphenate.chat.EMGroupManager.declineInvitation ( String  groupId,
String  inviter,
String  reason 
) throws HyphenateException

拒绝入群邀请。 异步方法见 asyncDeclineInvitation(String, String, String, EMCallBack)

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

参数
groupId群组 ID。
inviter邀请者 ID。
reason拒绝理由。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ deleteGroupSharedFile()

void com.hyphenate.chat.EMGroupManager.deleteGroupSharedFile ( String  groupId,
String  fileId 
) throws HyphenateException

删除群组指定的共享文件。 成员可以删除自己上传的文件,群组拥有者或者群组管理员可以删除所有的共享文件。 异步方法见 asyncDeleteGroupSharedFile(String, String, EMCallBack)

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

参数
groupId群组 ID。
fileId文件 ID。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ destroyGroup()

void com.hyphenate.chat.EMGroupManager.destroyGroup ( final String  groupId) throws HyphenateException

解散群组。 仅群主可调用此方法。 异步方法见 asyncDestroyGroup(String, EMCallBack)

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

参数
groupId群组 ID。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ downloadGroupSharedFile()

void com.hyphenate.chat.EMGroupManager.downloadGroupSharedFile ( String  groupId,
String  fileId,
String  savePath,
EMCallBack  callBack 
) throws HyphenateException

下载群组中指定的共享文件。 注意:callback 只做进度回调用。 异步方法见 asyncDownloadGroupSharedFile(String, String, String, EMCallBack)

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

参数
groupId群组 ID。
fileId文件 ID。
savePath文件保存路径。
callBack下载文件进度回调。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ fetchGroupAnnouncement()

String com.hyphenate.chat.EMGroupManager.fetchGroupAnnouncement ( String  groupId) throws HyphenateException

从服务器获取群组公告。 群成员可调用此方法。 异步方法见 asyncFetchGroupAnnouncement(String, EMValueCallBack)

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

参数
groupId群组 ID。
返回
群组公告。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ fetchGroupBlackList()

List< String > com.hyphenate.chat.EMGroupManager.fetchGroupBlackList ( String  groupId,
int  pageNum,
int  pageSize 
) throws HyphenateException

以分页方式从服务器获群组黑名单。 仅群主和管理员可调用此方法。 异步方法见 asyncFetchGroupBlackList(String, int, int, EMValueCallBack)

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

参数
groupId群组 ID。
pageNum当前页码,从 1 开始。
pageSize每页返回的黑名单上的用户数。
返回
返回分页获取的群组黑名单列表。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ fetchGroupMembers()

EMCursorResult< String > com.hyphenate.chat.EMGroupManager.fetchGroupMembers ( String  groupId,
String  cursor,
int  pageSize 
) throws HyphenateException

以分页方式获取群组成员列表。 返回的结果中,当 EMCursorResult.getCursor() 为空字符串 ("") 时,表示没有更多数据。 异步方法见 asyncFetchGroupMembers(String, String, int, EMValueCallBack)

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

例如:

EMCursorResult result = fetchGroupMembers(groupId, cursor, pageSize); // search 1
result = fetchGroupMembers(groupId, result.getCursor(), pageSize); // search 2
EMCursorResult< String > fetchGroupMembers(String groupId, String cursor, int pageSize)
Definition: EMGroupManager.java:2978
参数
groupId群组 ID。
cursor从这个游标位置开始取数据,首次获取数据时传 null 即可。
pageSize每页返回的群组成员数。
返回
分页获取结果 EMCursorResult,包含用于下次获取数据的 cursor 以及群组成员 list, 如果是最后一页,cursor 返回结果为空字符串。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ fetchGroupMuteList()

Map< String, Long > com.hyphenate.chat.EMGroupManager.fetchGroupMuteList ( String  groupId,
int  pageNum,
int  pageSize 
) throws HyphenateException

获取群组的禁言列表。 仅聊天室创建者和管理员可调用此方法。 异步方法见 asyncFetchGroupMuteList(String, int, int, EMValueCallBack)

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

参数
groupId群组 ID。
pageNum当前页码,从 1 开始。
pageSize每页返回的禁言成员数。
返回
返回的包含禁言成员 ID 及其禁言时长的 Map,其中每一项的 key 是禁言的成员 ID,value 是禁言时间,单位是毫秒。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ fetchGroupSharedFileList()

List< EMMucSharedFile > com.hyphenate.chat.EMGroupManager.fetchGroupSharedFileList ( String  groupId,
int  pageNum,
int  pageSize 
) throws HyphenateException

从服务器获取群组的共享文件列表。 异步方法见 asyncFetchGroupSharedFileList(String, int, int, EMValueCallBack)

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

参数
groupId群组 ID。
pageNum当前页码,从 1 开始。
pageSize每页返回的共享文件数。
返回
返回共享文件列表。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ fetchGroupWhiteList()

void com.hyphenate.chat.EMGroupManager.fetchGroupWhiteList ( final String  groupId,
final EMValueCallBack< List< String > >  callBack 
)

获取群组白名单列表。 仅聊天室创建者和管理员可调用此方法。

异步方法。

参数
groupId群组 ID。
callBack结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回白名单列表; 失败时回调 EMValueCallBack#onError(int, String)

◆ getAllGroups()

List< EMGroup > com.hyphenate.chat.EMGroupManager.getAllGroups ( )

获取当前(内存)用户的所有群组。 在调用此方法之前,可调用 loadAllGroups(),提前将数据从群组加载到内存; 如果未调用 loadAllGroups(),首次会从数据库中加载群组数据,之后再从内存中加载。

返回
群组列表。

◆ getBlockedUsers() [1/2]

List< String > com.hyphenate.chat.EMGroupManager.getBlockedUsers ( String  groupId) throws HyphenateException

获取群组的黑名单列表, 默认最多取 200 个. 仅群主和管理员可调用此方法。 异步方法见 asyncGetBlockedUsers(String, EMValueCallBack)

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

参数
groupId群组 ID。
返回
List 返回黑名单列表。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ getBlockedUsers() [2/2]

List< String > com.hyphenate.chat.EMGroupManager.getBlockedUsers ( String  groupId,
int  pageIndex,
int  pageSize 
) throws HyphenateException

以分页方式获取群组的黑名单。 仅群主和管理员可调用此方法。 异步方法见 asyncGetBlockedUsers(String, int, int, EMValueCallBack)

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

参数
groupId群组 ID。
pageIndex当前页码,从 1 开始。
pageSize每页返回的群组数。
返回
List 返回黑名单列表。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ getGroup()

EMGroup com.hyphenate.chat.EMGroupManager.getGroup ( String  groupId)

根据群组 ID,从内存中获得群组对象。

参数
groupId群组ID。
返回
返回群组对象。如果群组不存在,返回 null。

◆ getGroupFromServer() [1/2]

EMGroup com.hyphenate.chat.EMGroupManager.getGroupFromServer ( String  groupId) throws HyphenateException

从服务器获取群组的详细信息。 该方法不获取成员。如需获取成员,使用 fetchGroupMembers(String, String, int)。 异步方法见 asyncGetGroupFromServer(String, EMValueCallBack)

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

参数
groupId群组 ID。
返回
EMGroup 返回群组对象。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ getGroupFromServer() [2/2]

EMGroup com.hyphenate.chat.EMGroupManager.getGroupFromServer ( String  groupId,
boolean  fetchMembers 
) throws HyphenateException

从服务器获取群组的详细信息。 参数 fetchMembers 为 true 的时候,获取群成员。如需获取更多成员,使用 fetchGroupMembers(String, String, int)。 只有群成员才能获取群组的成员列表。

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

参数
groupId群组 ID。
fetchMembers是否获取成员列表,默认获取 200 成员的列表。
返回
EMGroup 返回更新后的群组对象。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ getJoinedGroupsFromServer() [1/3]

synchronized List< EMGroup > com.hyphenate.chat.EMGroupManager.getJoinedGroupsFromServer ( ) throws HyphenateException

从服务器获取当前用户的所有群组。 此操作只返回群组列表,并不获取群组的所有成员信息,如果要更新某个群组包括成员的全部信息,需要再调用 getGroupFromServer(String groupId)。 异步方法见 asyncGetJoinedGroupsFromServer(EMValueCallBack)

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

返回
当前用户已加入的群组列表。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError
弃用:
已废弃,请使用 getJoinedGroupsFromServer(int, int, boolean, boolean)

◆ getJoinedGroupsFromServer() [2/3]

synchronized List< EMGroup > com.hyphenate.chat.EMGroupManager.getJoinedGroupsFromServer ( int  pageIndex,
int  pageSize 
) throws HyphenateException

以分页方式从服务器获取当前用户已加入的群组。 此操作只返回群组列表,不包含群组的所有成员信息。如果要更新某个群组包括成员的全部信息,需要再调用 getGroupFromServer(String groupId)。 异步方法见 asyncGetJoinedGroupsFromServer(int, int, EMValueCallBack)

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

参数
pageIndex当前页码,从 1 开始。
pageSize每页返回的群组数。
返回
返回分页获取的群组列表。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError
弃用:
已废弃,请使用 getJoinedGroupsFromServer(int, int, boolean, boolean) 替代.

◆ getJoinedGroupsFromServer() [3/3]

synchronized List< EMGroup > com.hyphenate.chat.EMGroupManager.getJoinedGroupsFromServer ( int  pageIndex,
int  pageSize,
boolean  needMemberCount,
boolean  needRole 
) throws HyphenateException

以分页方式从服务器获取当前用户已加入的群组。 此操作只返回群组列表,不包含群组的所有成员信息。如果要更新某个群组包括成员的全部信息,需要再调用 getGroupFromServer(String groupId)。 异步方法见 asyncGetJoinedGroupsFromServer(int, int, boolean, boolean, EMValueCallBack)

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

参数
pageIndex当前页码,从 0 开始。
pageSize每页返回的群组数。pageSize 最大不超过 20
needMemberCount是否需要群成员人数。
needRole是否需要用户在群里的角色。
返回
返回分页获取的群组列表。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ getPublicGroupsFromServer()

EMCursorResult< EMGroupInfo > com.hyphenate.chat.EMGroupManager.getPublicGroupsFromServer ( int  pageSize,
String  cursor 
) throws HyphenateException

以分页方式从服务器获取公开群组。 异步方法见 asyncGetPublicGroupsFromServer(int, String, EMValueCallBack)

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

参数
pageSize每页返回的公开群组数。
cursor从这个游标位置开始取数据,首次获取数据时传 null 即可。
返回
分页获取结果 EMCursorResult,包含用于下次获取数据的 cursor 以及群组 list 的对象, 如果是最后一页,cursor 返回结果为空字符串。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ inviteUser()

void com.hyphenate.chat.EMGroupManager.inviteUser ( String  groupId,
String[]  beInvitedUsernames,
String  reason 
) throws HyphenateException

邀请用户加入群组。 前提:群组类型是 EMGroupStyle#EMGroupStylePrivateMemberCanInvite,即允许群成员邀请用户。 异步方法见 asyncInviteUser(String, String[], String, EMCallBack)

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

参数
groupId群组 ID。
beInvitedUsernames受邀用户的数组。
reason邀请原因。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ joinGroup()

void com.hyphenate.chat.EMGroupManager.joinGroup ( String  groupId) throws HyphenateException

当前登录用户加入公开群。 如果是自由加入的公开群,直接进入群组;需要验证的公开群需要等待群主同意。详见 EMGroupStyle。 异步方法见 asyncJoinGroup(String, EMCallBack)

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

参数
groupId群组 ID。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ leaveGroup()

void com.hyphenate.chat.EMGroupManager.leaveGroup ( String  groupId) throws HyphenateException

当前登录用户退出群组。

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

参数
groupId群组 ID。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ loadAllGroups()

synchronized void com.hyphenate.chat.EMGroupManager.loadAllGroups ( )

从数据库中加载所有群组。

◆ muteAllMembers()

void com.hyphenate.chat.EMGroupManager.muteAllMembers ( final String  groupId,
final EMValueCallBack< EMGroup callBack 
)

设置全员禁言。 仅群主和管理员可调用此方法。

异步方法。

参数
groupId群组 ID。
callBack结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回更新后的群组对象; 失败时回调 EMValueCallBack#onError(int, String)

◆ muteGroupMembers()

EMGroup com.hyphenate.chat.EMGroupManager.muteGroupMembers ( String  groupId,
List< String >  muteMembers,
long  duration 
) throws HyphenateException

将一组成员禁言。 仅群主和管理员可调用此方法。 异步方法见 asyncMuteGroupMembers(String, List, long, EMValueCallBack)

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

参数
groupId群组 ID。
muteMembers要禁言的用户列表。
duration禁言时间,单位是毫秒。若为 -1,表示永久禁言。
返回
返回更新后的群组对象。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ removeFromGroupWhiteList()

void com.hyphenate.chat.EMGroupManager.removeFromGroupWhiteList ( final String  groupId,
final List< String >  members,
final EMCallBack  callBack 
)

移除白名单。 仅群组创建者和管理员可调用此方法。

异步方法。

参数
groupId群组 ID。
members需要从白名单中移除的成员 ID 列表。
callBack结果回调,成功时回调 EMCallBack#onSuccess(), 失败时回调 EMCallBack#onError(int, String)

◆ removeGroupAdmin()

EMGroup com.hyphenate.chat.EMGroupManager.removeGroupAdmin ( String  groupId,
String  admin 
) throws HyphenateException

删除群组管理员。 仅群主可调用此方法。 异步方法见 asyncRemoveGroupAdmin(String, String, EMValueCallBack)

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

参数
groupId群组 ID。
admin删除的管理员 ID。
返回
返回更新后的群组对象。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ removeGroupChangeListener()

void com.hyphenate.chat.EMGroupManager.removeGroupChangeListener ( EMGroupChangeListener  listener)

移除群组变化监听器。 该方法在注册 addGroupChangeListener(EMGroupChangeListener)后调用。

参数
listener要移除的群组监听器。

◆ removeUserFromGroup()

void com.hyphenate.chat.EMGroupManager.removeUserFromGroup ( final String  groupId,
final String  username 
) throws HyphenateException

将群成员移出群组。 仅群主和管理员可调用此方法。 异步方法见 asyncRemoveUserFromGroup(String, String, EMCallBack)

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

参数
groupId群组的 ID。
username要删除成员的用户名。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ removeUsersFromGroup()

void com.hyphenate.chat.EMGroupManager.removeUsersFromGroup ( final String  groupId,
final List< String >  members 
) throws HyphenateException

将群成员移出群组。 仅群主和管理员可调用此方法。 异步方法见 removeUsersFromGroup(String, List)}。

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

参数
groupId群组 ID。
members要删除成员的用户名列表。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ unblockGroupMessage()

void com.hyphenate.chat.EMGroupManager.unblockGroupMessage ( String  groupId) throws HyphenateException

取消屏蔽群消息。 异步方法见 asyncUnblockGroupMessage(String, EMCallBack)

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

参数
groupId群组 ID。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ unblockUser()

void com.hyphenate.chat.EMGroupManager.unblockUser ( String  groupId,
String  username 
) throws HyphenateException

将用户从群组黑名单中移除。 仅群主和管理员可调用此方法。 异步方法见 asyncUnblockUser(String, String, EMCallBack)

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

参数
groupId群组 ID。
username要从黑名单中移除的用户。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ unblockUsers()

void com.hyphenate.chat.EMGroupManager.unblockUsers ( String  groupId,
List< String >  members 
) throws HyphenateException

将用户从群组黑名单移除。 仅群主和管理员可调用此方法。 异步方法见 asyncBlockUsers(String, List, EMCallBack)

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

参数
groupId群组 ID。
members要从黑名单中移除的用户列表。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ unmuteAllMembers()

void com.hyphenate.chat.EMGroupManager.unmuteAllMembers ( final String  groupId,
final EMValueCallBack< EMGroup callBack 
)

解除全员禁言。 仅群主和管理员可调用此方法。

异步方法。

参数
groupId群组 ID。
callBack结果回调,成功时回调 EMValueCallBack#onSuccess(Object), 返回更新后的群组对象; 失败时回调 EMValueCallBack#onError(int, String)

◆ unMuteGroupMembers()

EMGroup com.hyphenate.chat.EMGroupManager.unMuteGroupMembers ( String  groupId,
List< String >  members 
) throws HyphenateException

解除禁言。 仅群主和管理员可调用此方法。 异步方法见 asyncUnMuteGroupMembers(String, List, EMValueCallBack)

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

参数
groupId群组 ID。
members要解除禁言的用户列表。
返回
返回更新后的群组对象。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ updateGroupAnnouncement()

void com.hyphenate.chat.EMGroupManager.updateGroupAnnouncement ( String  groupId,
String  announcement 
) throws HyphenateException

更新群公告。 仅群主和管理员可调用此方法。 异步方法见 asyncUpdateGroupAnnouncement(String, String, EMCallBack)

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

参数
groupId群组 ID。
announcement公告内容。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ updateGroupExtension()

EMGroup com.hyphenate.chat.EMGroupManager.updateGroupExtension ( String  groupId,
String  extension 
) throws HyphenateException

更新群组扩展字段。 仅群主和管理员可调用此方法。

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

参数
groupId群组 ID。
extension群组扩展字段。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

◆ uploadGroupSharedFile()

EMMucSharedFile com.hyphenate.chat.EMGroupManager.uploadGroupSharedFile ( String  groupId,
String  filePath,
EMCallBack  callBack 
) throws HyphenateException

上传共享文件至群组。 注意:callback 只做进度回调用。 异步方法见 asyncUploadGroupSharedFile(String, String, EMValueCallBack)

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

参数
groupId群组 ID。
filePath文件本地路径。
callBack上传文件进度回调。
返回
EMMucSharedFile 返回共享文件属性对象。
异常
HyphenateException如果有异常会在此抛出,包括错误码和错误信息,详见 EMError

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