public interface ECGroupManager
可以使用该接口对群组进行管理,包括群组的创建、退出、解散、查询以及对 群组成员进行管理(邀请加入群组、将成员移除出群组、查询群组成员等)
标准的创建一个群组并且处理创建结果回调代码如下:
// 构建群组参数 ECGroup group = new ECGroup(); // 设置群组名称 group.setName("出彩中国人"); // 设置群组公告 group.setDeclare("欢迎体验云通讯群组功能"); // 设置群组类型,如:ECGroup.Scope.TEMP临时群组(100人) group.setScope(ECGroup.Scope.TEMP);; // 设置群组验证权限,如:需要身份验证ECGroup.Permission.NEED_AUTH group.setPermission(ECGroup.Permission.NEED_AUTH); // 设置群组创建者(可以不设置,服务器默认接口调用者为创建者) group.setOwner("$Tony的账号"); // 获得SDK群组创建管理类 ECGroupManager groupManager = ECDevice.getECGroupManager(); // 调用创建群组接口,设置创建结果回调 groupManager.createGroup(group, new ECGroupManager.OnCreatGroupListener() { public void onCreatGroupComplete(ECError error, ECGroup group) { if(error.errorCode == SdkErrorCode.REQUEST_SUCCESS) { // 群组创建成功 // 缓存创建的群组到数据库,同时通知UI进行更新 return ; } // 群组创建失败 Log.e("ECSDK_Demo" , "create group fail , errorCode=" + error.errorCode); } public void onComplete(ECError error) { // 不需要处理忽略 } });
void createGroup(ECGroup group, ECGroupManager.OnCreateGroupListener l)
group
- 创建群组所需要的参数信息l
- 创建群组请求回调ECGroupManager.OnCreateGroupListener.onCreateGroupComplete(ECError, ECGroup)
void modifyGroup(ECGroup group, ECGroupManager.OnModifyGroupListener l)
ECGroup.groupDomain 如果传入为Null 则删除该字段,否则修改该字段
group
- 需要修改的群组参数信息l
- 修改群组结果回调ECGroupManager.OnModifyGroupListener
void deleteGroup(java.lang.String groupId, ECGroupManager.OnDeleteGroupListener l)
groupId
- 需要被删除的群组IDl
- 删除群组回调ECGroupManager.OnDeleteGroupListener
void searchPublicGroups(ECGroupMatch match, ECGroupManager.OnSearchPublicGroupsListener l)
match
- 群组搜索条件l
- 搜索结果回调ECGroupManager.OnSearchPublicGroupsListener
void getGroupDetail(java.lang.String groupId, ECGroupManager.OnGetGroupDetailListener l)
groupId
- 群组IDl
- 查询群组结果回调ECGroupManager.OnGetGroupDetailListener
void joinGroup(java.lang.String groupId, java.lang.String declare, ECGroupManager.OnJoinGroupListener l)
groupId
- 申请加入的群组IDdeclare
- 申请加入理由l
- 申请结果回调ECGroupManager.OnJoinGroupListener
void inviteJoinGroup(java.lang.String groupId, java.lang.String reason, java.lang.String[] members, ECGroupManager.InvitationMode confirm, ECGroupManager.OnInviteJoinGroupListener l)
groupId
- 邀请加入的群组IDreason
- 邀请加入群组的邀请愿意members
- 邀请的成员confirm
- ECGroupManager.InvitationMode.NEED_CONFIRM
需要对方验证 , ECGroupManager.InvitationMode.FORCE_PULL
不需要对方验证l
- 邀请结果回调ECGroupManager.OnInviteJoinGroupListener
,
ECGroupManager.InvitationMode
void inviteJoinGroup(java.lang.String groupId, java.lang.String reason, java.lang.String[] members, int confirm, ECGroupManager.OnInviteJoinGroupListener l)
void deleteGroupMember(java.lang.String groupId, java.lang.String member, ECGroupManager.OnDeleteGroupMembersListener l)
groupId
- 群组IDmember
- 移除的成员l
- 移除结果回调ECGroupManager.OnDeleteGroupMembersListener
void quitGroup(java.lang.String groupId, ECGroupManager.OnQuitGroupListener l)
groupId
- 群组 IDl
- 退出结果ECGroupManager.OnQuitGroupListener
void modifyMemberCard(ECGroupMember member, ECGroupManager.OnModifyMemberCardListener l)
member
- 需要修改的群组成员账号l
- 修改结果回调void queryMemberCard(java.lang.String voip, java.lang.String groupId, ECGroupManager.OnQueryMemberCardListener l)
voip
- 需要查询的群组成员账号groupId
- 成员所在的群组l
- 查询结果回调ECGroupManager.OnQueryMemberCardListener
void queryGroupMembers(java.lang.String groupId, ECGroupManager.OnQueryGroupMembersListener l)
groupId
- 需要查询的成员所在的群组IDl
- 查询结果ECGroupManager.OnQueryGroupMembersListener
void queryGroupMembers(java.lang.String groupId, java.lang.String borderMember, int pageSize, ECGroupManager.OnQueryGroupMembersListener l)
groupId
- 需要查询的成员所在的群组IDborderMember
- 开始群组成员账号pageSize
- 获取的群组成员个数l
- 结果回调ECGroupManager.OnQueryGroupMembersListener
void queryOwnGroups(ECGroupManager.Target target, ECGroupManager.OnQueryOwnGroupsListener l)
l
- 结果回调target
- 返回值类型ECGroupManager.OnQueryOwnGroupsListener
,
ECGroupManager.Target
@Deprecated void queryOwnGroups(ECGroupManager.OnQueryOwnGroupsListener l)
queryOwnGroups(Target, OnQueryOwnGroupsListener)
@Deprecated void queryOwnGroups(java.lang.String borderGroupid, int pageSize, ECGroupManager.OnQueryOwnGroupsListener l)
queryOwnGroups(String, Target, int, OnQueryOwnGroupsListener)
void queryOwnGroups(java.lang.String borderGroupid, ECGroupManager.Target target, int pageSize, ECGroupManager.OnQueryOwnGroupsListener l)
borderGroupid
- 开始群组IDpageSize
- 获取的群组个数target
- 查询的群组类型(讨论组/群组/全部)l
- 结果回调分批次获取群组信息
,
ECGroupManager.OnQueryOwnGroupsListener
,
ECGroupManager.Target
@Deprecated void forbidMemberSpeakStatus(java.lang.String groupId, java.lang.String member, ESpeakStatus ecStatus, ECGroupManager.OnForbidMemberSpeakStatusListener l)
void forbidMemberSpeakStatus(java.lang.String groupId, java.lang.String member, ECGroupManager.ESpeakStatus ecStatus, ECGroupManager.OnForbidMemberSpeakStatusListener l)
groupId
- 操作的群组IDmember
- 操作的成员ecStatus
- 操作的状态l
- 操作结果回调ECGroupManager.ESpeakStatus
,
ECGroupManager.OnForbidMemberSpeakStatusListener
void ackJoinGroupRequest(java.lang.String groupId, java.lang.String member, ECAckType type, ECGroupManager.OnAckJoinGroupRequestListener l)
groupId
- 申请的群组IDmember
- 申请者账号type
- 验证回复类型(同意或者拒绝)l
- 回复结果回调ECAckType
,
ECGroupManager.OnAckJoinGroupRequestListener
void ackInviteJoinGroupRequest(java.lang.String groupId, ECAckType type, java.lang.String invitee, ECGroupManager.OnAckInviteJoinGroupRequestListener l)
groupId
- 邀请加入的群组IDtype
- 回复类型(同意或者拒绝)l
- 回复结果回调ECAckType
,
ECGroupManager.OnAckInviteJoinGroupRequestListener
void setGroupMessageOption(ECGroupOption options, ECGroupManager.OnSetGroupMessageOptionListener l)
options
- 接收规则l
- 设置结果回调ECGroupOption
,
ECGroupManager.OnSetGroupMessageOptionListener
void setGroupMemberRole(java.lang.String groupId, java.lang.String member, ECGroupManager.ECGroupMemberRole role, ECGroupManager.OnSetGroupMemberRoleListener l)
1、任命普通的群组成员为管理员
2、任命成员为新的群组所有者(群组转让)
3、群组所有者取消已任命的群组管理员
groupId
- 群组idmember
- 被设置成员的账号role
- 2管理员,3成员l
- 回调接口ECGroupManager.ECGroupMemberRole
void setGroupIsAnonymity(java.lang.String groupId, boolean isAnonymity, ECGroupManager.OnSetGroupIsAnonymityListener listener)
groupId
- 群组唯一标识(群组ID)isAnonymity
- 是否匿名聊天listener
- 设置结果回调接口Copyright © 2017 All rights reserved.