public class EMGroupManager
extends java.lang.Object
| 限定符和类型 | 字段和说明 |
|---|---|
static java.lang.String |
MUC_NS_USER |
| 限定符和类型 | 方法和说明 |
|---|---|
void |
acceptApplication(java.lang.String username,
java.lang.String groupId)
同意加群申请
accept the application of the user to join this group
|
EMGroup |
acceptInvitation(java.lang.String groupId)
接受加入群组邀请
accept the member's inviatation to join the group
|
void |
addGroupChangeListener(GroupChangeListener listener)
注册群变动事件监听
register the group change listener
|
void |
addUsersToGroup(java.lang.String groupId,
java.lang.String[] newmembers)
向群组中添加新的成员
add users to the group and only the group owner can do it.
|
void |
applyJoinToGroup(java.lang.String groupId,
java.lang.String reason)
申请加入某个群(用于加入需要验证的公开群)
apply to join the group
|
void |
asyncGetAllPublicGroupsFromServer(EMValueCallBack<java.util.List<EMGroupInfo>> callback)
Asynchronously get all public groups from servers
|
void |
asyncGetGroupsFromServer(EMValueCallBack<java.util.List<EMGroup>> callback)
asynchronously get all groups from servers and sync with local groups
|
void |
blockGroupMessage(java.lang.String groupId)
屏蔽群消息,(还是群里面的成员,但不再接收群消息)
set to disable receiving the group messages
|
void |
blockUser(java.lang.String groupId,
java.lang.String username)
将用户加到群组的黑名单,被加入黑名单的用户无法加入群,无法收发此群的消息
(只有群主才能设置群的黑名单)
set to block member who will be not allowed to receive any group messages
and only the group owner can do it.
|
void |
changeGroupName(java.lang.String groupId,
java.lang.String changedGroupName)
改变群组的名称(群主才能调用此方法)
change the group name and only group owner can do it.
|
EMGroup |
createGroup(java.lang.String groupName,
java.lang.String desc,
java.lang.String[] members)
已过时。
使用 createPublicGroup 和cretePrivateGroup
|
EMGroup |
createOrUpdateLocalGroup(EMGroup group)
创建或更新本地的数据库和内存中的群组
create or update local group
|
EMGroup |
createPrivateGroup(java.lang.String groupName,
java.lang.String desc,
java.lang.String[] members)
在服务器端创建一个私有群.
|
EMGroup |
createPrivateGroup(java.lang.String groupName,
java.lang.String desc,
java.lang.String[] members,
boolean allowInvites)
在服务器端创建一个私有群,可以设置是否允许群成员邀请其他人入群
create a private group and specify if that's alowed to invite other users t join the group or not.
|
EMGroup |
createPrivateGroup(java.lang.String groupName,
java.lang.String desc,
java.lang.String[] allMembers,
boolean allowInvites,
int maxUsers)
在服务器端创建一个私有群,可以设置是否允许群成员邀请其他人入群
create a private group and specify if that's alowed to invite other users t join the group or not and the max members
|
EMGroup |
createPublicGroup(java.lang.String groupName,
java.lang.String desc,
java.lang.String[] members,
boolean needApprovalRequired)
在服务器端创建一个公开群,创建成功的群组,能被用户搜索到以及加入进来
create a public group and the group can be discoverred by any user and the max members by default is 200
|
EMGroup |
createPublicGroup(java.lang.String groupName,
java.lang.String desc,
java.lang.String[] allMembers,
boolean needApprovalRequired,
int maxUsers)
在服务器端创建一个公开群,创建成功的群组,能被用户搜索到以及加入进来
create a public group and the group can be discoverred by any user and specify the max users
|
void |
declineApplication(java.lang.String username,
java.lang.String groupId,
java.lang.String reason)
拒绝加群申请
reject the application of user to join this group
|
void |
deleteLocalGroup(java.lang.String groupId)
删除client存储的群组 注意:这是内部函数,暴露出来是为了被sdk测试代码调用。
|
void |
exitAndDeleteGroup(java.lang.String groupId)
解散群组 (只有群组的创建者才能调用此函数来删除)
dismiss the group and only the group owner can do it.
|
void |
exitFromGroup(java.lang.String groupId)
当前登录用户退出群组
the member exit the group
|
java.util.List<EMGroup> |
getAllGroups()
获取当前(内存)用户的所有群组
get all grops from cache
|
java.util.List<EMGroupInfo> |
getAllPublicGroupsFromServer()
已过时。
|
java.util.List<java.lang.String> |
getBlockedUsers(java.lang.String groupId)
获取群组的黑名单用户列表
(只有群主才能调用此函数)
get the list of blocked users and only the group owner can do it.
|
EMGroup |
getGroup(java.lang.String groupId)
根据群组ID,获得群组对象
get local group from cache by group id
|
EMGroup |
getGroupFromServer(java.lang.String groupId)
从服务器获取群组的详细信息和最新的成员列表(获取完后不会自动存入本地)
get the group from the server but did not upate local group. but you can update the local group by using
api createOrUpdateLocalGroup
|
java.util.List<EMGroup> |
getGroupsFromServer()
从服务器端获取当前用户的所有群组 (此操作只返回群组列表,并不获取群组的所有成员信息,如果要更新某个群组包括成员的全部信息,需要再调用
getGroupFromServer(String groupId),,一般来说取到后需要保存一下,调用createOrUpdateLocalGroup(EMGroup))
this api will get groups from remote server and update local groups |
static EMGroupManager |
getInstance() |
java.util.List<EMGroup> |
getJoinedGroupsFromServer()
从服务器端获取当前用户的所有群组 (此操作只返回群组列表,并不获取群组的所有成员信息,如果要更新某个群组包括成员的全部信息,需要再调用
getGroupFromServer(String groupId),,一般来说取到后需要保存一下,调用createOrUpdateLocalGroup(EMGroup)) |
EMCursorResult<EMGroupInfo> |
getPublicGroupsFromServer(int pageSize,
java.lang.String cursor)
从服务器获取公开群组
|
void |
inviteUser(java.lang.String groupId,
java.lang.String[] beInvitedUsernames,
java.lang.String reason)
群成员邀请用户加入群组 (如果群组设置成可以成员邀请,现在的群组成员可以邀请其他用户加入)
invite other users to join the group if the group has been set to allow member to invite
|
void |
joinGroup(java.lang.String groupId)
当前登录用户加入公开群(如果是自由加入的公开群,直接进入群组;需要验证的公开群需要等待群主同意)
join the group by the group id
|
void |
joinGroupsAfterLogin()
已过时。
|
void |
loadAllGroups()
load all local groups synchronrously
|
void |
loadAllGroups(EMCallBack callback)
load所有本地的群组
load all local groups asynchronously from db to cache, please ensure to call this api before geting the group from cache
|
void |
removeGroupChangeListener(GroupChangeListener listener)
移除群组变化监听器
remove group change listener
|
void |
removeUserFromGroup(java.lang.String groupId,
java.lang.String username)
从群组中删除成员
remove the member from the group and only the group owner can do it.
|
void |
setAutoAcceptInvitation(boolean autoAccept)
是否自动接受群组邀请 如果设为true,sdk 会对群组邀请自动回复加入
|
void |
unblockGroupMessage(java.lang.String groupId)
取消屏蔽群消息
set to enable to receive the group message again
|
void |
unblockUser(java.lang.String groupId,
java.lang.String username)
将用户从群组的黑名单移除
remove the blocked user from the group balcklist
|
public static final java.lang.String MUC_NS_USER
public static EMGroupManager getInstance()
public void loadAllGroups(EMCallBack callback)
callback - public java.util.List<EMGroup> getAllGroups()
public EMGroup getGroup(java.lang.String groupId)
groupId - 群组的IDpublic void loadAllGroups()
public void joinGroupsAfterLogin()
public EMGroup createPublicGroup(java.lang.String groupName, java.lang.String desc, java.lang.String[] members, boolean needApprovalRequired) throws com.easemob.exceptions.EaseMobException
groupName - ,群组名称desc - , 群组描述members - ,群组里的初始成员 --- 用户名needApprovalRequired - ,用户加入此群时,needApprovalRequired为false时直接join即可加入进来,否则需要申请加入,群主同意后才行com.easemob.exceptions.EaseMobExceptionpublic EMGroup createPublicGroup(java.lang.String groupName, java.lang.String desc, java.lang.String[] allMembers, boolean needApprovalRequired, int maxUsers) throws com.easemob.exceptions.EaseMobException
groupName - ,群组名称desc - , 群组描述members - ,群组里的初始成员 --- 用户名needApprovalRequired - ,用户加入此群时,needApprovalRequired为false时直接join即可加入进来,否则需要申请加入,群主同意后才行maxUsers - 群的最大人数,缺省是200人,最大可传2000, 如果给-1,是unlimitedcom.easemob.exceptions.EaseMobExceptionpublic EMGroup createPrivateGroup(java.lang.String groupName, java.lang.String desc, java.lang.String[] members) throws com.easemob.exceptions.EaseMobException
groupName - ,群组名称desc - , 群组描述members - ,群组里的成员 --- 用户名com.easemob.exceptions.EaseMobExceptionpublic EMGroup createPrivateGroup(java.lang.String groupName, java.lang.String desc, java.lang.String[] members, boolean allowInvites) throws com.easemob.exceptions.EaseMobException
groupName - ,群组名称desc - , 群组描述members - ,群组里的成员 --- 用户名allowInvites - . 群成员是否可以邀请其他用户加入群组,缺省是falsecom.easemob.exceptions.EaseMobExceptionpublic EMGroup createPrivateGroup(java.lang.String groupName, java.lang.String desc, java.lang.String[] allMembers, boolean allowInvites, int maxUsers) throws com.easemob.exceptions.EaseMobException
groupName - ,群组名称desc - , 群组描述members - ,群组里的成员 --- 用户名allowInvites - . 群成员是否可以邀请其他用户加入群组,缺省是false群的最大人数,缺省是200人,最大为2000,, - 如果给-1,是unlimitedcom.easemob.exceptions.EaseMobExceptionpublic EMGroup createGroup(java.lang.String groupName, java.lang.String desc, java.lang.String[] members) throws com.easemob.exceptions.EaseMobException
groupName - ,群组名称desc - , 群组描述members - ,群组里的成员 --- 用户名com.easemob.exceptions.EaseMobExceptionpublic void exitAndDeleteGroup(java.lang.String groupId)
throws com.easemob.exceptions.EaseMobException
groupId - 群组的IDcom.easemob.exceptions.EaseMobExceptionpublic void deleteLocalGroup(java.lang.String groupId)
groupId - public void addUsersToGroup(java.lang.String groupId,
java.lang.String[] newmembers)
throws com.easemob.exceptions.EaseMobException
groupId - 群组的IDnewmembers - 待添加的新成员用户名com.easemob.exceptions.EaseMobExceptionpublic void removeUserFromGroup(java.lang.String groupId,
java.lang.String username)
throws com.easemob.exceptions.EaseMobException
groupId - 群组的IDusername - 待删除成员的用户名com.easemob.exceptions.EaseMobExceptionpublic void exitFromGroup(java.lang.String groupId)
throws com.easemob.exceptions.EaseMobException
groupId - 群组IDcom.easemob.exceptions.EaseMobExceptionpublic EMGroup getGroupFromServer(java.lang.String groupId) throws com.easemob.exceptions.EaseMobException
groupId - 群组的IDcom.easemob.exceptions.EaseMobExceptionpublic EMGroup createOrUpdateLocalGroup(EMGroup group)
group - public java.util.List<EMGroup> getGroupsFromServer() throws com.easemob.exceptions.EaseMobException
getGroupFromServer(String groupId),,一般来说取到后需要保存一下,调用createOrUpdateLocalGroup(EMGroup))
this api will get groups from remote server and update local groupscom.easemob.exceptions.EaseMobExceptionpublic java.util.List<EMGroup> getJoinedGroupsFromServer() throws com.easemob.exceptions.EaseMobException
getGroupFromServer(String groupId),,一般来说取到后需要保存一下,调用createOrUpdateLocalGroup(EMGroup))com.easemob.exceptions.EaseMobExceptionpublic void asyncGetGroupsFromServer(EMValueCallBack<java.util.List<EMGroup>> callback)
callback - public java.util.List<EMGroupInfo> getAllPublicGroupsFromServer() throws com.easemob.exceptions.EaseMobException
getPublicGroupsFromServer(int, String)替代com.easemob.exceptions.EaseMobExceptionpublic EMCursorResult<EMGroupInfo> getPublicGroupsFromServer(int pageSize, java.lang.String cursor) throws com.easemob.exceptions.EaseMobException
pageSize - 获取多少条cursor - 用于分批获取数据的cursor,首次获取数据时传null即可com.easemob.exceptions.EaseMobExceptionpublic void asyncGetAllPublicGroupsFromServer(EMValueCallBack<java.util.List<EMGroupInfo>> callback)
callback - public void joinGroup(java.lang.String groupId)
throws com.easemob.exceptions.EaseMobException
groupId - com.easemob.exceptions.EaseMobExceptionpublic void changeGroupName(java.lang.String groupId,
java.lang.String changedGroupName)
throws com.easemob.exceptions.EaseMobException
groupId - 需要改变名称的群组的idchangedGroupName - 改变后的群组名称com.easemob.exceptions.EaseMobExceptionpublic void addGroupChangeListener(GroupChangeListener listener)
listener - GroupChangeListenerpublic void removeGroupChangeListener(GroupChangeListener listener)
listener - public EMGroup acceptInvitation(java.lang.String groupId) throws com.easemob.exceptions.EaseMobException
groupId - 群组IDcom.easemob.exceptions.EaseMobExceptionpublic void acceptApplication(java.lang.String username,
java.lang.String groupId)
throws com.easemob.exceptions.EaseMobException
username - 申请人usernamegroupId - 要申请加入的群idcom.easemob.exceptions.EaseMobExceptionpublic void declineApplication(java.lang.String username,
java.lang.String groupId,
java.lang.String reason)
throws com.easemob.exceptions.EaseMobException
username - 被拒绝的用户的usernamegroupId - 群idreason - 拒绝理由com.easemob.exceptions.EaseMobExceptionpublic void setAutoAcceptInvitation(boolean autoAccept)
autoAccept - public void inviteUser(java.lang.String groupId,
java.lang.String[] beInvitedUsernames,
java.lang.String reason)
throws com.easemob.exceptions.EaseMobException
groupId - 群组IdbeInvitedUsernames - 被邀请人username的数组reason - com.easemob.exceptions.EaseMobExceptionpublic void applyJoinToGroup(java.lang.String groupId,
java.lang.String reason)
throws com.easemob.exceptions.EaseMobException
groupId - 群idreason - 申请加入的reasoncom.easemob.exceptions.EaseMobExceptionpublic void blockGroupMessage(java.lang.String groupId)
throws com.easemob.exceptions.EaseMobException
groupId - 群idEasemobExceptioncom.easemob.exceptions.EaseMobExceptionpublic void unblockGroupMessage(java.lang.String groupId)
throws com.easemob.exceptions.EaseMobException
groupId - com.easemob.exceptions.EaseMobExceptionpublic void blockUser(java.lang.String groupId,
java.lang.String username)
throws com.easemob.exceptions.EaseMobException
groupId - 群组的idusername - 待屏蔽的用户名com.easemob.exceptions.EaseMobException - 出错会抛出public void unblockUser(java.lang.String groupId,
java.lang.String username)
throws com.easemob.exceptions.EaseMobException
groupId - 群组的idusername - 待解除屏蔽的 用户名com.easemob.exceptions.EaseMobExceptionpublic java.util.List<java.lang.String> getBlockedUsers(java.lang.String groupId)
throws com.easemob.exceptions.EaseMobException
com.easemob.exceptions.EaseMobException - 获取失败Copyright © 2014 EaseMob.com. All Rights Reserved.