hyphenate_SDK3.0
3.8.5
hyphenatejavaIMSDK
|
类 | |
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 | 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< 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 | 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< 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 |
群组管理, 用于管理群组的创建,删除,成员管理等操作
void com.hyphenate.chat.EMGroupManager.acceptApplication | ( | String | username, |
String | groupId | ||
) | throws HyphenateException |
同意加群申请 需要群组拥有者或者管理员权限 异步方法见asyncAcceptApplication(String, String, EMCallBack)
同步方法,会阻塞当前线程
username | 申请人ID |
groupId | 群组ID |
HyphenateException | 错误信息详见EMError |
EMGroup com.hyphenate.chat.EMGroupManager.acceptInvitation | ( | String | groupId, |
String | inviter | ||
) | throws HyphenateException |
接受加入群的邀请 异步方法见asyncAcceptInvitation(String, String, EMValueCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
inviter | 邀请人ID |
HyphenateException | 错误信息详见EMError |
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 |
void com.hyphenate.chat.EMGroupManager.addGroupChangeListener | ( | EMGroupChangeListener | listener | ) |
注册群变动事件监听 注册后,需要配合removeGroupChangeListener(EMGroupChangeListener)使用
listener | 注册的群组事件监听 |
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) |
void com.hyphenate.chat.EMGroupManager.addUsersToGroup | ( | String | groupId, |
String[] | newmembers | ||
) | throws HyphenateException |
向群组中添加新的成员 需要群组拥有者或者管理员权限 异步方法见asyncAddUsersToGroup(String, String[], EMCallBack)
同步方法,会阻塞当前线程
groupId | 群组的ID |
newmembers | 待添加的新成员数组 |
HyphenateException | 错误信息详见EMError |
void com.hyphenate.chat.EMGroupManager.addUsersToGroup | ( | String | groupId, |
String[] | newmembers, | ||
String | welcomeMessage | ||
) | throws HyphenateException |
向群组中添加新的成员 需要群组拥有者或者管理员权限 异步方法见asyncAddUsersToGroup(String, String[], EMCallBack)
同步方法,会阻塞当前线程
groupId | 群组的ID |
newmembers | 待添加的新成员数组 |
welcomeMessage | 邀请信息 |
HyphenateException | 错误信息详见EMError |
void com.hyphenate.chat.EMGroupManager.applyJoinToGroup | ( | String | groupId, |
String | reason | ||
) | throws HyphenateException |
申请加入群组 前提:群组类型为EMGroupStyle#EMGroupStylePublicJoinNeedApproval,即需要需要验证的公开群 异步方法见asyncApplyJoinToGroup(String, String, EMCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
reason | 申请加入的原因 |
HyphenateException | 错误信息详见EMError |
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) |
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) |
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) |
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) |
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) |
void com.hyphenate.chat.EMGroupManager.asyncBlockGroupMessage | ( | final String | groupId, |
final EMCallBack | callback | ||
) |
屏蔽群消息 还是群成员,但不再接收群消息 同步方法见blockGroupMessage(String)
异步方法
groupId | 群组ID |
callback | 结果回调,成功时回调EMCallBack#onSuccess(), 失败时回调EMCallBack#onError(int, String) |
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) |
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) |
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) |
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) |
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) |
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) |
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) |
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) |
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) |
void com.hyphenate.chat.EMGroupManager.asyncDestroyGroup | ( | final String | groupId, |
final EMCallBack | callback | ||
) |
解散群组 需要群组owner权限 同步方法见destroyGroup(String)
异步方法
groupId | 群组ID |
callback | 结果回调,成功时回调EMCallBack#onSuccess(), 失败时回调EMCallBack#onError(int, String) |
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) |
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) |
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) |
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) |
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) |
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) |
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) |
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) |
void com.hyphenate.chat.EMGroupManager.asyncGetGroupFromServer | ( | final String | groupId, |
final EMValueCallBack< EMGroup > | callback | ||
) |
从服务器获取群组的详细信息 同步方法见getGroupFromServer(String)
异步方法
groupId | 群组ID |
callback | 结果回调,成功时回调EMCallBack#onSuccess(), 失败时回调EMCallBack#onError(int, String) |
void com.hyphenate.chat.EMGroupManager.asyncGetJoinedGroupsFromServer | ( | final EMValueCallBack< List< EMGroup >> | callback | ) |
从服务器端获取当前用户的所有群组 此操作只返回群组列表,并不获取群组的所有成员信息,如果要更新某个群组包括成员的全部信息,需要再调用 getGroupFromServer(String groupId) 同步方法见getJoinedGroupsFromServer()
异步方法
callback | 结果回调,成功时回调EMValueCallBack#onSuccess(Object),返回已加入的群组列表 失败时回调EMValueCallBack#onError(int, String) |
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) |
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) |
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) |
void com.hyphenate.chat.EMGroupManager.asyncJoinGroup | ( | final String | groupId, |
final EMCallBack | callback | ||
) |
当前登录用户加入公开群 如果是自由加入的公开群,直接进入群组;需要验证的公开群需要等待群主同意,详见EMGroupStyle 同步方法见joinGroup(String)
异步方法
groupId | 群组ID |
callback | 结果回调,成功时回调EMCallBack#onSuccess(), 失败时回调EMCallBack#onError(int, String) |
void com.hyphenate.chat.EMGroupManager.asyncLeaveGroup | ( | final String | groupId, |
final EMCallBack | callback | ||
) |
当前登录用户退出群组
异步方法
groupId | 群组ID |
callback | 结果回调,成功时回调EMCallBack#onSuccess(), 失败时回调EMCallBack#onError(int, String) |
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) |
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) |
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) |
void com.hyphenate.chat.EMGroupManager.asyncUnblockGroupMessage | ( | final String | groupId, |
final EMCallBack | callback | ||
) |
取消屏蔽群消息 同步方法见unblockGroupMessage(String)
异步方法
groupId | 群组ID |
callback | 结果回调,成功时回调EMCallBack#onSuccess(), 失败时回调EMCallBack#onError(int, String) |
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) |
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) |
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) |
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) |
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) |
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) |
void com.hyphenate.chat.EMGroupManager.blockGroupMessage | ( | String | groupId | ) | throws HyphenateException |
屏蔽群消息 还是群成员,但不再接收群消息 异步方法见asyncBlockGroupMessage(String, EMCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
HyphenateException | 错误信息详见EMError |
void com.hyphenate.chat.EMGroupManager.blockUser | ( | String | groupId, |
String | username | ||
) | throws HyphenateException |
将用户加入到群组黑名单 被加入黑名单的用户无法加入群,无法收发此群的消息 需要群组拥有者或者管理员权限 异步方法见asyncBlockUser(String, String, EMCallBack)
v3.3.0后:被加入到黑名单的用户会被先移出群,再加入到黑名单中,之前版本没有移出群的动作
同步方法,会阻塞当前线程
groupId | 群组ID |
username | 待加入黑名单的用户名 |
HyphenateException | 错误信息详见EMError |
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 |
void com.hyphenate.chat.EMGroupManager.changeGroupDescription | ( | String | groupId, |
String | changedDescription | ||
) | throws HyphenateException |
修改群描述 需要群组拥有者或者管理员权限 异步方法见asyncChangeGroupDescription(String, String, EMCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
changedDescription | 改变后的群描述 |
HyphenateException | 错误信息详见EMError |
void com.hyphenate.chat.EMGroupManager.changeGroupName | ( | String | groupId, |
String | changedGroupName | ||
) | throws HyphenateException |
改变群组的名称 需要群组拥有者或者管理员权限 异步方法见asyncChangeGroupName(String, String, EMCallBack)
同步方法,会阻塞当前线程
groupId | 需要改变名称的群组的id |
changedGroupName | 改变后的群组名称 |
HyphenateException | 错误信息详见EMError |
EMGroup com.hyphenate.chat.EMGroupManager.changeOwner | ( | String | groupId, |
String | newOwner | ||
) | throws HyphenateException |
移交群组所有权 需要群组owner权限 异步方法见asyncChangeOwner(String, String, EMValueCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
newOwner | 新的群主 |
HyphenateException | 错误信息详见EMError |
void com.hyphenate.chat.EMGroupManager.checkIfInGroupWhiteList | ( | final String | groupId, |
EMValueCallBack< Boolean > | callBack | ||
) |
检查自己是否在群组白名单中
异步方法
groupId | 群组ID |
callBack | 结果回调,成功时回调EMValueCallBack#onSuccess(Object), 返回是否在群组白名单的布尔值; 失败时回调EMValueCallBack#onError(int, String) |
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 |
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 |
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 |
void com.hyphenate.chat.EMGroupManager.deleteGroupSharedFile | ( | String | groupId, |
String | fileId | ||
) | throws HyphenateException |
删除群组指定的共享文件 成员可以删除自己上传的文件,群组拥有者或者群组管理员可以删除所有的共享文件 异步方法见asyncDeleteGroupSharedFile(String, String, EMCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
fileId | 文件ID |
HyphenateException | 错误信息详见EMError |
void com.hyphenate.chat.EMGroupManager.destroyGroup | ( | final String | groupId | ) | throws HyphenateException |
解散群组 需要群组owner权限 异步方法见asyncDestroyGroup(String, EMCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
HyphenateException | 错误信息详见EMError |
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 |
String com.hyphenate.chat.EMGroupManager.fetchGroupAnnouncement | ( | String | groupId | ) | throws HyphenateException |
从服务器获取群组公告 需要是群成员权限 异步方法见asyncFetchGroupAnnouncement(String, EMValueCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
HyphenateException | 错误信息详见EMError |
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 |
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即可 |
HyphenateException | 错误信息详见EMError |
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 | 每页拉取的数量 |
HyphenateException | 错误信息详见EMError |
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 |
void com.hyphenate.chat.EMGroupManager.fetchGroupWhiteList | ( | final String | groupId, |
final EMValueCallBack< List< String >> | callBack | ||
) |
从服务器获取白名单成员列表 需要群组拥有者或者管理员权限
异步方法
groupId | 群组ID |
callBack | 结果回调,成功时回调EMValueCallBack#onSuccess(Object), 返回白名单列表; 失败时回调EMValueCallBack#onError(int, String) |
List<EMGroup> com.hyphenate.chat.EMGroupManager.getAllGroups | ( | ) |
获取当前(内存)用户的所有群组 在调用此方法之前,可以在适当的时机调用loadAllGroups(),提前从数据将群组加载到内存中; 如果没有调用过loadAllGroups(),首次会从数据库中加载群组数据,之后再从内存中加载
List<String> com.hyphenate.chat.EMGroupManager.getBlockedUsers | ( | String | groupId | ) | throws HyphenateException |
获取群组的黑名单列表, 默认最多取200个 需要群组拥有者或者管理员权限 异步方法见asyncGetBlockedUsers(String, EMValueCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
HyphenateException | 错误信息详见EMError |
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 | 每页拉取的数量 |
HyphenateException | 错误信息详见EMError |
EMGroup com.hyphenate.chat.EMGroupManager.getGroup | ( | String | groupId | ) |
根据群组ID,从内存中获得群组对象
groupId | 群组ID |
EMGroup com.hyphenate.chat.EMGroupManager.getGroupFromServer | ( | String | groupId | ) | throws HyphenateException |
从服务器获取群组的详细信息 不获取成员,如需获取成员,使用 fetchGroupMembers(String, String, int) 异步方法见asyncGetGroupFromServer(String, EMValueCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
HyphenateException | 错误信息详见EMError |
EMGroup com.hyphenate.chat.EMGroupManager.getGroupFromServer | ( | String | groupId, |
boolean | fetchMembers | ||
) | throws HyphenateException |
从服务器获取群组的详细信息 参数fetchMembers为true的时候,获取群成员,如需获取更多成员,使用 fetchGroupMembers(String, String, int) 只有群成员才能获取群组的成员列表
同步方法,会阻塞当前线程
groupId | 群组ID |
fetchMembers | 是否获取成员列表,默认取200人的成员列表 |
HyphenateException | 错误信息详见EMError |
synchronized List<EMGroup> com.hyphenate.chat.EMGroupManager.getJoinedGroupsFromServer | ( | ) | throws HyphenateException |
从服务器端获取当前用户的所有群组 此操作只返回群组列表,并不获取群组的所有成员信息,如果要更新某个群组包括成员的全部信息,需要再调用 getGroupFromServer(String groupId) 异步方法见asyncGetJoinedGroupsFromServer(EMValueCallBack)
同步方法,会阻塞当前线程
HyphenateException | 错误信息详见EMError |
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 |
EMCursorResult<EMGroupInfo> com.hyphenate.chat.EMGroupManager.getPublicGroupsFromServer | ( | int | pageSize, |
String | cursor | ||
) | throws HyphenateException |
分页从服务器获取公开群组 异步方法见asyncGetPublicGroupsFromServer(int, String, EMValueCallBack)
同步方法,会阻塞当前线程
pageSize | 一次取的数量 |
cursor | 从这个游标位置开始取数据,首次获取数据时传null即可 |
HyphenateException | 错误码详见com.hyphenate.EMError |
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 |
void com.hyphenate.chat.EMGroupManager.joinGroup | ( | String | groupId | ) | throws HyphenateException |
当前登录用户加入公开群 如果是自由加入的公开群,直接进入群组;需要验证的公开群需要等待群主同意,详见EMGroupStyle 异步方法见asyncJoinGroup(String, EMCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
HyphenateException | 错误信息详见EMError |
void com.hyphenate.chat.EMGroupManager.leaveGroup | ( | String | groupId | ) | throws HyphenateException |
synchronized void com.hyphenate.chat.EMGroupManager.loadAllGroups | ( | ) |
从数据库中加载所有群组
void com.hyphenate.chat.EMGroupManager.muteAllMembers | ( | final String | groupId, |
final EMValueCallBack< EMGroup > | callBack | ||
) |
禁言所有成员 需要群组拥有者或者管理员权限
异步方法
groupId | 群组ID |
callBack | 结果回调,成功时回调EMValueCallBack#onSuccess(Object), 返回更新后的群组对象; 失败时回调EMValueCallBack#onError(int, String) |
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 |
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) |
EMGroup com.hyphenate.chat.EMGroupManager.removeGroupAdmin | ( | String | groupId, |
String | admin | ||
) | throws HyphenateException |
删除群组管理员 需要群组owner权限 异步方法见asyncRemoveGroupAdmin(String, String, EMValueCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
admin | 删除的管理员ID |
HyphenateException | 错误信息详见EMError |
void com.hyphenate.chat.EMGroupManager.removeGroupChangeListener | ( | EMGroupChangeListener | listener | ) |
移除群组变化监听器 在注册addGroupChangeListener(EMGroupChangeListener)后调用此方法
listener | 要解注册的群组监听 |
void com.hyphenate.chat.EMGroupManager.removeUserFromGroup | ( | final String | groupId, |
final String | username | ||
) | throws HyphenateException |
从群组中删除成员 需要群组拥有者或者管理员权限 异步方法见asyncRemoveUserFromGroup(String, String, EMCallBack)
同步方法,会阻塞当前线程
groupId | 群组的ID |
username | 待删除成员的用户名 |
HyphenateException | 错误信息详见EMError |
void com.hyphenate.chat.EMGroupManager.removeUsersFromGroup | ( | final String | groupId, |
final List< String > | members | ||
) | throws HyphenateException |
从群组中删除成员 需要群组拥有者或者管理员权限 异步方法见removeUsersFromGroup(String, List)}
同步方法,会阻塞当前线程
groupId | 群组ID |
members | 待删除成员的用户名集合 |
HyphenateException | 错误信息详见EMError |
void com.hyphenate.chat.EMGroupManager.unblockGroupMessage | ( | String | groupId | ) | throws HyphenateException |
取消屏蔽群消息 异步方法见asyncUnblockGroupMessage(String, EMCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
HyphenateException | 错误信息详见EMError |
void com.hyphenate.chat.EMGroupManager.unblockUser | ( | String | groupId, |
String | username | ||
) | throws HyphenateException |
将用户从群组黑名单移除 需要群组拥有者或者管理员权限 异步方法见asyncUnblockUser(String, String, EMCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
username | 待从黑名单中移除的用户 |
HyphenateException | 错误信息详见EMError |
void com.hyphenate.chat.EMGroupManager.unblockUsers | ( | String | groupId, |
List< String > | members | ||
) | throws HyphenateException |
将用户从群组黑名单移除 需要群组拥有者或者管理员权限 异步方法见asyncBlockUsers(String, List, EMCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
members | 待从黑名单中移除的用户集合 |
HyphenateException | 错误信息详见EMError |
void com.hyphenate.chat.EMGroupManager.unmuteAllMembers | ( | final String | groupId, |
final EMValueCallBack< EMGroup > | callBack | ||
) |
解除所有成员禁言 需要群组拥有者或者管理员权限
异步方法
groupId | 群组ID |
callBack | 结果回调,成功时回调EMValueCallBack#onSuccess(Object), 返回更新后的群组对象; 失败时回调EMValueCallBack#onError(int, String) |
EMGroup com.hyphenate.chat.EMGroupManager.unMuteGroupMembers | ( | String | groupId, |
List< String > | members | ||
) | throws HyphenateException |
解除指定用户的禁言 需要群组拥有者或者管理员权限 异步方法见asyncUnMuteGroupMembers(String, List, EMValueCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
members | 需要解除禁言的用户列表 |
HyphenateException | 错误信息详见EMError |
void com.hyphenate.chat.EMGroupManager.updateGroupAnnouncement | ( | String | groupId, |
String | announcement | ||
) | throws HyphenateException |
更新群公告 需要群组拥有者或者管理员权限 异步方法见asyncUpdateGroupAnnouncement(String, String, EMCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
announcement | 公告内容 |
HyphenateException | 错误信息详见EMError |
EMGroup com.hyphenate.chat.EMGroupManager.updateGroupExtension | ( | String | groupId, |
String | extension | ||
) | throws HyphenateException |
更新群组扩展字段 需要群组拥有者或者管理员权限
同步方法,会阻塞当前线程
groupId | 群组ID |
extension | 群组扩展字段 |
HyphenateException | 错误信息详见EMError |
EMMucSharedFile com.hyphenate.chat.EMGroupManager.uploadGroupSharedFile | ( | String | groupId, |
String | filePath, | ||
EMCallBack | callBack | ||
) | throws HyphenateException |
上传共享文件至群组 注意:callback只做进度回调用 异步方法见asyncUploadGroupSharedFile(String, String, EMCallBack)
同步方法,会阻塞当前线程
groupId | 群组ID |
filePath | 文件本地路径 |
callBack | 上传文件进度回调 |
HyphenateException | 错误信息详见EMError |