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 |
changeGroupDescription(java.lang.String groupId,
java.lang.String changedDescription)
修改群描述
|
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.EaseMobException
public 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.EaseMobException
public 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.EaseMobException
public 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.EaseMobException
public 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.EaseMobException
public 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.EaseMobException
public void exitAndDeleteGroup(java.lang.String groupId) throws com.easemob.exceptions.EaseMobException
groupId
- 群组的IDcom.easemob.exceptions.EaseMobException
public 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.EaseMobException
public void removeUserFromGroup(java.lang.String groupId, java.lang.String username) throws com.easemob.exceptions.EaseMobException
groupId
- 群组的IDusername
- 待删除成员的用户名com.easemob.exceptions.EaseMobException
public void exitFromGroup(java.lang.String groupId) throws com.easemob.exceptions.EaseMobException
groupId
- 群组IDcom.easemob.exceptions.EaseMobException
public EMGroup getGroupFromServer(java.lang.String groupId) throws com.easemob.exceptions.EaseMobException
groupId
- 群组的IDcom.easemob.exceptions.EaseMobException
public 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.EaseMobException
public java.util.List<EMGroup> getJoinedGroupsFromServer() throws com.easemob.exceptions.EaseMobException
getGroupFromServer(String groupId)
,,一般来说取到后需要保存一下,调用createOrUpdateLocalGroup(EMGroup)
)com.easemob.exceptions.EaseMobException
public 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.EaseMobException
public EMCursorResult<EMGroupInfo> getPublicGroupsFromServer(int pageSize, java.lang.String cursor) throws com.easemob.exceptions.EaseMobException
pageSize
- 获取多少条cursor
- 用于分批获取数据的cursor,首次获取数据时传null即可com.easemob.exceptions.EaseMobException
public 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.EaseMobException
public void changeGroupName(java.lang.String groupId, java.lang.String changedGroupName) throws com.easemob.exceptions.EaseMobException
groupId
- 需要改变名称的群组的idchangedGroupName
- 改变后的群组名称com.easemob.exceptions.EaseMobException
public void changeGroupDescription(java.lang.String groupId, java.lang.String changedDescription) throws com.easemob.exceptions.EaseMobException
groupId
- 群idchangedDescription
- 改变后的群描述com.easemob.exceptions.EaseMobException
public void addGroupChangeListener(GroupChangeListener listener)
listener
- GroupChangeListener
public void removeGroupChangeListener(GroupChangeListener listener)
listener
- public EMGroup acceptInvitation(java.lang.String groupId) throws com.easemob.exceptions.EaseMobException
groupId
- 群组IDcom.easemob.exceptions.EaseMobException
public void acceptApplication(java.lang.String username, java.lang.String groupId) throws com.easemob.exceptions.EaseMobException
username
- 申请人usernamegroupId
- 要申请加入的群idcom.easemob.exceptions.EaseMobException
public 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.EaseMobException
public 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.EaseMobException
public void applyJoinToGroup(java.lang.String groupId, java.lang.String reason) throws com.easemob.exceptions.EaseMobException
groupId
- 群idreason
- 申请加入的reasoncom.easemob.exceptions.EaseMobException
public void blockGroupMessage(java.lang.String groupId) throws com.easemob.exceptions.EaseMobException
groupId
- 群idEasemobException
com.easemob.exceptions.EaseMobException
public void unblockGroupMessage(java.lang.String groupId) throws com.easemob.exceptions.EaseMobException
groupId
- com.easemob.exceptions.EaseMobException
public 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.EaseMobException
public 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.