hyphenate_SDK3.0  3.8.6.1
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
 
void asyncGetJoinedGroupsFromServer (final EMValueCallBack< List< EMGroup >> callback)
 
void asyncGetJoinedGroupsFromServer (final int pageIndex, final int pageSize, final EMValueCallBack< List< EMGroup >> 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 aysncMuteGroupMembers (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)
 
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)
 
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

增加群组管理员 需要群组owner权限,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需要加入白名单的成员ID列表
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 
)

增加群组管理员 需要群组owner权限,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)

3.3.0后:被加入到黑名单的用户会被先移出群,再加入到黑名单中,之前版本没有移出群的动作

异步方法

参数
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)

3.3.0后:被加入到黑名单的用户会被先移出群,再加入到黑名单中,之前版本没有移出群的动作

异步方法

参数
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 
)

移交群组所有权 需要群组owner权限 同步方法见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 可以设置如下参数: 群最大成员数,默认值为200; 群类型,详见EMGroupManager.EMGroupStyle,默认为EMGroupStyle#EMGroupStylePrivateOnlyOwnerInvite; 邀请进群是否需要对方同意,默认为false,即直接被邀请后进群; 还可以设置群详情扩展
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 
)

解散群组 需要群组owner权限 同步方法见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)

◆ 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)

◆ 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)

◆ 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)

◆ asyncGetJoinedGroupsFromServer() [1/2]

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

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

异步方法

参数
callback结果回调,成功时回调EMValueCallBack#onSuccess(Object),返回已加入的群组列表 失败时回调EMValueCallBack#onError(int, String)

◆ asyncGetJoinedGroupsFromServer() [2/2]

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)

◆ 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)

◆ asyncRemoveGroupAdmin()

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

删除群组管理员 需要群组owner权限 同步方法见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)

◆ 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()

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#onSuccess(), 上传文件进度回调EMCallBack#onProgress(int, String), 失败时回调EMCallBack#onError(int, String)

◆ aysncMuteGroupMembers()

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

禁止指定的群组成员发言 需要群组拥有者或者管理员权限 同步方法见muteGroupMembers(String, List, long)

异步方法

参数
groupId群组ID
muteMembers需要禁言的用户列表
duration禁言的时间,单位是毫秒
callback结果回调,成功时回调EMValueCallBack#onSuccess(Object), 返回更新后的群组对象; 失败时回调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)

v3.3.0后:被加入到黑名单的用户会被先移出群,再加入到黑名单中,之前版本没有移出群的动作

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

参数
groupId群组ID
username待加入黑名单的用户名
异常
HyphenateException错误信息详见EMError

◆ blockUsers()

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

将用户加入到群组黑名单 被加入黑名单的用户无法加入群,无法收发此群的消息 需要群组拥有者或者管理员权限 异步方法见asyncBlockUsers(String, List, EMCallBack)

v3.3.0后:被加入到黑名单的用户会被先移出群,再加入到黑名单中,之前版本没有移出群的动作

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

参数
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

移交群组所有权 需要群组owner权限 异步方法见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 可以设置如下参数: 群最大成员数,默认值为200; 群类型,详见EMGroupManager.EMGroupStyle,默认为EMGroupStyle#EMGroupStylePrivateOnlyOwnerInvite; 邀请进群是否需要对方同意,默认为false,即直接被邀请后进群; 还可以设置群详情扩展
返回
返回创建成功的群对象
异常
HyphenateException错误信息详见com.hyphenate.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

解散群组 需要群组owner权限 异步方法见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
参数
groupId群组ID
cursor一次取的数量
pageSize从这个游标位置开始取数据,首次获取数据时传null即可
返回
分页获取结果 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 返回黑名单列表,默认最多200条数据
异常
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/2]

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

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

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

返回
当前用户已加入的群组列表
异常
HyphenateException错误信息详见EMError

◆ getJoinedGroupsFromServer() [2/2]

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

◆ 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错误码详见com.hyphenate.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

禁止指定的群组成员发言 需要群组拥有者或者管理员权限 异步方法见aysncMuteGroupMembers(String, List, long, EMValueCallBack)

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

参数
groupId群组ID
muteMembers需要禁言的用户列表
duration禁言的时间,单位是毫秒
返回
返回更新后的群组对象
异常
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

删除群组管理员 需要群组owner权限 异步方法见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, EMCallBack)

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

参数
groupId群组ID
filePath文件本地路径
callBack上传文件进度回调
返回
EMMucSharedFile 返回共享文件属性对象
异常
HyphenateException错误信息详见EMError

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