类
enum	EMGroupStyle

Public 成员函数
List< EMGroup >	getAllGroups ()

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	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	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< EMGroup >	getJoinedGroupsFromServer () throws HyphenateException

synchronized List< EMGroup >	getJoinedGroupsFromServer (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< EMGroupInfo >	getPublicGroupsFromServer (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	unblockUser (String groupId, String username) throws HyphenateException

void	asyncUnblockUser (final String groupId, final String username, 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	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< EMMucSharedFile >	fetchGroupSharedFileList (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

同意加群申请

参数

username	申请人username
groupId	要申请加入的群id

异常

HyphenateException

◆ acceptInvitation()

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

接受加入群的邀请

参数

groupId
inviter

返回: 用户已经同意邀请的群组对象

◆ addGroupAdmin()

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

增加群组管理员，需要owner权限，admin無权限

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

参数

groupId
admin

返回

异常

HyphenateException

◆ addGroupChangeListener()

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

注册群变动事件监听

参数

listener

参见: EMGroupChangeListener

◆ addUsersToGroup()

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

向群组中添加新的成员

参数

groupId	群组的ID
newmembers	待添加的新成员用户名

异常

HyphenateException

◆ applyJoinToGroup()

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

申请加入某个群（用于加入需要验证的公开群）

参数

groupId
reason	申请加入的原因

◆ asyncAcceptApplication()

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

同意加群申请

参数

username	申请人username
groupId	要申请加入的群id
callback

◆ asyncAcceptInvitation()

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

接受加入群的邀请

参数

groupId
inviter
callback

◆ asyncAddGroupAdmin()

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

增加群组管理员，需要owner权限

参数

groupId
admin
callback

◆ asyncAddUsersToGroup()

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

向群组中添加新的成员

参数

groupId	群组的ID
newmembers	待添加的新成员用户名
callback

◆ asyncApplyJoinToGroup()

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

申请加入某个群（用于加入需要验证的公开群）

参数

groupId
reason	申请加入的原因
callback

◆ asyncBlockGroupMessage()

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

屏蔽群消息，（还是群里面的成员，但不再接收群消息

参数

groupId
callback

◆ asyncBlockUser()

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

将用户加到群组的黑名单，被加入黑名单的用户无法加入群，无法收发此群的消息（只有群主才能设置群的黑名单）

参数

groupId	群组的id
username	待屏蔽的用户名
callback

◆ asyncChangeGroupDescription()

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

修改群描述(群主才能调用此方法)

参数

groupId	群id
changedDescription	改变后的群描述
callBack

◆ asyncChangeGroupName()

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

改变群组的名称(群主才能调用此方法)

参数

groupId	需要改变名称的群组的id
changedGroupName	改变后的群组名称
callback

◆ asyncChangeOwner()

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

群组所有权给他人

参数

groupId
newOwner
callback

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

在IM服务器创建一个群组

参数

groupName	群组的名字
desc	群组敘述
allMembers	群成员数组,不需要群主id
reason	邀请群成员加入时的邀请信息
option	群的设置
callback

◆ asyncDeclineApplication()

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

拒绝加群申请

参数

username	申请人username
groupId	要申请加入的群id
reason	拒绝的理由
callback

◆ asyncDeclineInvitation()

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

拒绝加入群的邀请

参数

groupId
inviter
reason	拒绝的原因
callback

◆ asyncDeleteGroupSharedFile()

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

异步从群组里删除这个共享文件

参数

groupId	群id
fileId	文件id
callBack	回调

◆ asyncDestroyGroup()

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

解散群组（只有群组的创建者才能调用此函数来删除）

参数

groupId
callback

◆ asyncDownloadGroupSharedFile()

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

异步下载群里的某个共享文件

参数

groupId	群id
fileId	文件id
savePath	文件保存路径
callBack	回调

◆ asyncFetchGroupAnnouncement()

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

异步从服务器获取群公告

参数

groupId	群组id
callBack	回调

◆ asyncFetchGroupBlackList()

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

从服务器获分页获取群组黑名单，方法适用于成员数量较大的群组，需要群组拥有者或者管理员权限

参数

groupId	群组id
pageNum	分页号
pageSize	分页大小
callBack	异步函数回调方法

◆ asyncFetchGroupMembers()

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

获取群组成员列表, 异步方法

EMCursorResult result = fetchGroupMembers(groupId, cursor, pageSize); // search 1 result = fetchGroupMembers(groupId, result.getCursor(), pageSize); // search 2

参数

groupId
cursor	cursor是记录上次查询返回结果所在位置，继续查询时传入cursor, 返回结果继续上次查询
pageSize
callback

◆ asyncFetchGroupMuteList()

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

获取群组的禁言列表，需要群组拥有者或者管理员权限

参数

groupId
pageNum
pageSize
callBack	callback function that receive the executed result. Map.entry.key is username of mute action, Map.entry.value is expired time of banning post action.

◆ asyncFetchGroupSharedFileList()

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

异步从服务器获取群组的共享文件列表

参数

groupId	群id
pageNum	分页号
pageSize	分页大小
callBack	回调

◆ asyncGetBlockedUsers() [1/2]

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

获取群组的黑名单用户列表, 默认最多取200个成员（只有群主才能调用此函数）

参数

callback

◆ asyncGetBlockedUsers() [2/2]

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

获取群组的黑名单用户列表（只有群主才能调用此函数）

参数

callback

◆ asyncGetGroupFromServer()

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

从服务器获取群组的详细信息和最新的成员列表

参数

groupId
callback	包含更新的群组对象

◆ asyncGetJoinedGroupsFromServer() [1/2]

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

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

参数

callback 包含群组列表

◆ asyncGetJoinedGroupsFromServer() [2/2]

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

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

参数

pageIndex
pageSize
callback	群组列表

◆ asyncGetPublicGroupsFromServer()

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

从服务器获取公开群组

参数

pageSize	获取多少条
cursor	用于分批获取数据的cursor,首次获取数据时传null即可
callback	包含用于下次获取数据的cursor以及群组list的对象

◆ asyncInviteUser()

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

群成员邀请用户加入群组（如果群组设置成可以成员邀请，现在的群组成员可以邀请其他用户加入）

参数

groupId	群组Id
beInvitedUsernames	被邀请人username的数组
reason
callback

◆ asyncJoinGroup()

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

当前登录用户加入公开群(如果是自由加入的公开群，直接进入群组；需要验证的公开群需要等待群主同意)

参数

groupId

◆ asyncLeaveGroup()

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

当前登录用户退出群组

参数

groupId
callback

◆ asyncRemoveGroupAdmin()

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

删除群组管理员，需要owner权限

参数

groupId
admin
callback

◆ asyncRemoveUserFromGroup()

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

从群组中删除成员

参数

groupId	群组的ID
username	待删除成员的用户名
callback

◆ asyncUnblockGroupMessage()

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

取消屏蔽群消息

参数

groupId
callback

◆ asyncUnblockUser()

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

将用户从群组的黑名单移除

参数

groupId	群组的id
username	待解除屏蔽的用户名
callback

◆ asyncUnMuteGroupMembers()

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

取消禁言，需要群组拥有者或者管理员权限

参数

groupId
members
callback

◆ asyncUpdateGroupAnnouncement()

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

异步更新群公告

参数

groupId	群id
announcement	公告内容
callBack	回调

◆ asyncUploadGroupSharedFile()

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

异步上传共享文件至群组

参数

groupId	群id
filePath	文件本地路径
callBack	回调

◆ aysncMuteGroupMembers()

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

禁止某些群组成员发言, 需要群组拥有者或者管理员权限

参数

groupId
muteMembers	需要禁言的群组成员
duration	禁言持续时间，单位是毫秒
callback

◆ blockGroupMessage()

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

屏蔽群消息，（还是群里面的成员，但不再接收群消息

参数

groupId

异常

HyphenateException

◆ blockUser()

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

将用户加到群组的黑名单，被加入黑名单的用户无法加入群，无法收发此群的消息（只有群主才能设置群的黑名单）。 3.3.0群组改造和之前版本的区别：被加入到黑名单的用户会被先移出群，再加入到黑名单中，之前版本没有移出群的动作。

参数

groupId	群组的id
username	待屏蔽的用户名

异常

HyphenateException

◆ changeGroupDescription()

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

修改群描述(群主才能调用此方法)

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

参数

groupId	群id
changedDescription	改变后的群描述

异常

HyphenateException

◆ changeGroupName()

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

改变群组的名称(群主才能调用此方法)

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

参数

groupId	需要改变名称的群组的id
changedGroupName	改变后的群组名称

异常

HyphenateException

◆ changeOwner()

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

群组所有权给他人

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

参数

groupId
newOwner

返回

异常

HyphenateException

◆ createGroup()

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

在IM服务器创建一个群组

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

参数

groupName	群组的名字
desc	群组敘述
allMembers	群成员数组,不需要群主id
reason	邀请群成员加入时的邀请信息
option	群的设置

◆ declineApplication()

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

拒绝加群申请

参数

username	申请人username
groupId	要申请加入的群id
reason	拒绝的理由

异常

HyphenateException

◆ declineInvitation()

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

拒绝加入群的邀请

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

参数

groupId
inviter
reason,拒绝的原因

◆ deleteGroupSharedFile()

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

从群组里删除这个共享文件

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

参数

groupId	群id
fileId	文件id

异常

HyphenateException

◆ destroyGroup()

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

解散群组（只有群组的创建者才能调用此函数来删除）

参数

groupId

异常

HyphenateException

◆ downloadGroupSharedFile()

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

下载群里的某个共享文件，注意callback只做进度回调用

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

参数

groupId	群id
fileId	文件id
savePath	文件保存路径
callBack	回调

异常

HyphenateException

◆ fetchGroupAnnouncement()

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

从服务器获取群公告

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

参数

groupId 群组id

返回

异常

HyphenateException

◆ fetchGroupBlackList()

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

从服务器获分页获取群组黑名单，方法适用于成员数量较大的群组，需要群组拥有者或者管理员权限

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

参数

groupId	群组id
pageNum	分页号
pageSize	分页大小

返回

异常

HyphenateException

◆ fetchGroupMembers()

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

获取群组成员列表，最后一页返回结果EMCursorResult.getCursor()返回为空字符串

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

参数

groupId
cursor
pageSize

返回

异常

HyphenateException

◆ fetchGroupMuteList()

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

获取群组的禁言列表，需要群组拥有者或者管理员权限

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

参数

groupId
pageNum
pageSize

返回: Map.entry.key 是禁言的成员id，Map.entry.value是禁言动作存在的时间，单位是毫秒。

异常

HyphenateException

◆ fetchGroupSharedFileList()

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

从服务器获取群组的共享文件列表

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

参数

groupId	群id
pageNum	分页号
pageSize	分页大小

返回

异常

HyphenateException

◆ getAllGroups()

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

获取当前(内存)用户的所有群组

返回: 群组列表

◆ getBlockedUsers() [1/2]

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

获取群组的黑名单用户列表, 默认最多取200个成员（只有群主才能调用此函数） return List

异常

HyphenateException 获取失败

◆ getBlockedUsers() [2/2]

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

获取群组的黑名单用户列表（只有群主才能调用此函数）

return List

异常

HyphenateException 获取失败

◆ 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

从服务器获取群组的详细信息

参数

groupId

返回: EMGroup 更新的群组对象

◆ getGroupFromServer() [2/2]

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

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

参数

fetchMembers 是否获取成员列表，默认取200人的成员列表

返回: EMGroup 更新的群组对象

◆ getJoinedGroupsFromServer() [1/2]

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

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

返回: 群组列表

异常

HyphenateException

◆ getJoinedGroupsFromServer() [2/2]

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

从服务器端获取当前用户的所有群组（此操作只返回群组列表，并不获取群组的所有成员信息，如果要更新某个群组包括成员的全部信息，需要再调用。从第一页开始取。 getGroupFromServer(String groupId)

参数

pageIndex	start from 1
pageSize

返回: 群组列表

异常

HyphenateException

◆ getPublicGroupsFromServer()

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

从服务器获取公开群组

参数

pageSize	获取多少条
cursor	用于分批获取数据的cursor,首次获取数据时传null即可

返回: 包含用于下次获取数据的cursor以及群组list的对象，如果是最后一页，cursor返回结果为空字符串。

异常

HyphenateException

◆ inviteUser()

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

群成员邀请用户加入群组（如果群组设置成可以成员邀请，现在的群组成员可以邀请其他用户加入）

参数

groupId	群组Id
beInvitedUsernames	被邀请人username的数组
reason

异常

HyphenateException

◆ joinGroup()

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

当前登录用户加入公开群(如果是自由加入的公开群，直接进入群组；需要验证的公开群需要等待群主同意)

参数

groupId

◆ leaveGroup()

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

当前登录用户退出群组

参数

groupId

异常

HyphenateException

◆ loadAllGroups()

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

同步加载所有群组

◆ muteGroupMembers()

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

禁止某些群组成员发言, 需要群组拥有者或者管理员权限

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

参数

groupId
muteMembers	禁言的用户列表
duration	禁言的时间，单位是毫秒

返回

异常

HyphenateException

◆ removeGroupAdmin()

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

删除群组管理员，需要owner权限

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

参数

groupId
admin

返回

异常

HyphenateException

◆ removeGroupChangeListener()

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

移除群组变化监听器

参数

listener

◆ removeUserFromGroup()

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

从群组中删除成员

参数

groupId	群组的ID
username	待删除成员的用户名

异常

HyphenateException

◆ unblockGroupMessage()

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

取消屏蔽群消息

参数

groupId

异常

HyphenateException

◆ unblockUser()

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

将用户从群组的黑名单移除

参数

groupId	群组的id
username	待解除屏蔽的用户名

◆ unMuteGroupMembers()

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

解除禁言, 需要群组拥有者或者管理员权限

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

参数

groupId
members

返回

异常

HyphenateException

◆ updateGroupAnnouncement()

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

更新群公告

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

参数

groupId	群id
announcement	公告内容

异常

HyphenateException

◆ updateGroupExtension()

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

更新群组扩展字段

参数

groupId	群组id
extension	群组扩展字段

◆ uploadGroupSharedFile()

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

上传共享文件至群组，注意callback只做进度回调用

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

参数

groupId	群id
filePath	文件本地路径
callBack	回调

返回

异常

HyphenateException

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

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

类

Public 成员函数

详细描述

成员函数说明

◆ acceptApplication()

◆ acceptInvitation()

◆ addGroupAdmin()

◆ addGroupChangeListener()

◆ addUsersToGroup()

◆ applyJoinToGroup()

◆ asyncAcceptApplication()

◆ asyncAcceptInvitation()

◆ asyncAddGroupAdmin()

◆ asyncAddUsersToGroup()

◆ asyncApplyJoinToGroup()

◆ asyncBlockGroupMessage()

◆ asyncBlockUser()

◆ asyncChangeGroupDescription()

◆ asyncChangeGroupName()

◆ asyncChangeOwner()

◆ asyncCreateGroup()

◆ asyncDeclineApplication()

◆ asyncDeclineInvitation()

◆ asyncDeleteGroupSharedFile()

◆ asyncDestroyGroup()

◆ asyncDownloadGroupSharedFile()

◆ asyncFetchGroupAnnouncement()

◆ asyncFetchGroupBlackList()

◆ asyncFetchGroupMembers()

◆ asyncFetchGroupMuteList()

◆ asyncFetchGroupSharedFileList()

◆ asyncGetBlockedUsers() [1/2]

◆ asyncGetBlockedUsers() [2/2]

◆ asyncGetGroupFromServer()

◆ asyncGetJoinedGroupsFromServer() [1/2]

◆ asyncGetJoinedGroupsFromServer() [2/2]

◆ asyncGetPublicGroupsFromServer()

◆ asyncInviteUser()

◆ asyncJoinGroup()

◆ asyncLeaveGroup()

◆ asyncRemoveGroupAdmin()

◆ asyncRemoveUserFromGroup()

◆ asyncUnblockGroupMessage()

◆ asyncUnblockUser()

◆ asyncUnMuteGroupMembers()

◆ asyncUpdateGroupAnnouncement()

◆ asyncUploadGroupSharedFile()

◆ aysncMuteGroupMembers()

◆ blockGroupMessage()

◆ blockUser()

◆ changeGroupDescription()

◆ changeGroupName()

◆ changeOwner()

◆ createGroup()

◆ declineApplication()

◆ declineInvitation()

◆ deleteGroupSharedFile()

◆ destroyGroup()

◆ downloadGroupSharedFile()

◆ fetchGroupAnnouncement()

◆ fetchGroupBlackList()

◆ fetchGroupMembers()

◆ fetchGroupMuteList()

◆ fetchGroupSharedFileList()

◆ getAllGroups()

◆ getBlockedUsers() [1/2]

◆ getBlockedUsers() [2/2]

◆ getGroup()

◆ getGroupFromServer() [1/2]

◆ getGroupFromServer() [2/2]

◆ getJoinedGroupsFromServer() [1/2]

◆ getJoinedGroupsFromServer() [2/2]

◆ getPublicGroupsFromServer()

◆ inviteUser()

◆ joinGroup()

◆ leaveGroup()

◆ loadAllGroups()

◆ muteGroupMembers()

◆ removeGroupAdmin()

◆ removeGroupChangeListener()