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.OnModifyGroupListenervoid deleteGroup(java.lang.String groupId,
ECGroupManager.OnDeleteGroupListener l)
groupId - 需要被删除的群组IDl - 删除群组回调ECGroupManager.OnDeleteGroupListenervoid searchPublicGroups(ECGroupMatch match, ECGroupManager.OnSearchPublicGroupsListener l)
match - 群组搜索条件l - 搜索结果回调ECGroupManager.OnSearchPublicGroupsListenervoid getGroupDetail(java.lang.String groupId,
ECGroupManager.OnGetGroupDetailListener l)
groupId - 群组IDl - 查询群组结果回调ECGroupManager.OnGetGroupDetailListenervoid joinGroup(java.lang.String groupId,
java.lang.String declare,
ECGroupManager.OnJoinGroupListener l)
groupId - 申请加入的群组IDdeclare - 申请加入理由l - 申请结果回调ECGroupManager.OnJoinGroupListenervoid 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.InvitationModevoid 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.OnDeleteGroupMembersListenervoid quitGroup(java.lang.String groupId,
ECGroupManager.OnQuitGroupListener l)
groupId - 群组 IDl - 退出结果ECGroupManager.OnQuitGroupListenervoid 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.OnQueryMemberCardListenervoid queryGroupMembers(java.lang.String groupId,
ECGroupManager.OnQueryGroupMembersListener l)
groupId - 需要查询的成员所在的群组IDl - 查询结果ECGroupManager.OnQueryGroupMembersListenervoid queryGroupMembers(java.lang.String groupId,
java.lang.String borderMember,
int pageSize,
ECGroupManager.OnQueryGroupMembersListener l)
groupId - 需要查询的成员所在的群组IDborderMember - 开始群组成员账号pageSize - 获取的群组成员个数l - 结果回调ECGroupManager.OnQueryGroupMembersListenervoid 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.OnForbidMemberSpeakStatusListenervoid ackJoinGroupRequest(java.lang.String groupId,
java.lang.String member,
ECAckType type,
ECGroupManager.OnAckJoinGroupRequestListener l)
groupId - 申请的群组IDmember - 申请者账号type - 验证回复类型(同意或者拒绝)l - 回复结果回调ECAckType,
ECGroupManager.OnAckJoinGroupRequestListenervoid ackInviteJoinGroupRequest(java.lang.String groupId,
ECAckType type,
java.lang.String invitee,
ECGroupManager.OnAckInviteJoinGroupRequestListener l)
groupId - 邀请加入的群组IDtype - 回复类型(同意或者拒绝)l - 回复结果回调ECAckType,
ECGroupManager.OnAckInviteJoinGroupRequestListenervoid setGroupMessageOption(ECGroupOption options, ECGroupManager.OnSetGroupMessageOptionListener l)
options - 接收规则l - 设置结果回调ECGroupOption,
ECGroupManager.OnSetGroupMessageOptionListenervoid 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.ECGroupMemberRolevoid setGroupIsAnonymity(java.lang.String groupId,
boolean isAnonymity,
ECGroupManager.OnSetGroupIsAnonymityListener listener)
groupId - 群组唯一标识(群组ID)isAnonymity - 是否匿名聊天listener - 设置结果回调接口Copyright © 2017 All rights reserved.