群组功能

功能概述

群组消息

群组管理

创建群组

//新建创建群组对象
var obj = new RL_YTX.CreateGroupBuilder();
//设置群组名称
obj.setGroupName(“出彩中国人”);
//设置群组公告
obj. setDeclared(“欢迎体验云通讯群组功能”);
//设置群组类型，如：1临时群组（100人）
obj. setScope(1);
//设置群组验证权限，如：需要身份验证2
obj. setPermission(2);
//设置为讨论组，该字段默认为2，表示群组，创建讨论组时设置为1
obj.setTarget(1);
RL_YTX.createGroup(obj, function(obj){
//获取新建群组id
var groupId = obj.data;
//更新页面
}, function(obj){
//创建群组失败
});                                       

主动加入群组 

//新建加入群组对象
var builder= new RL_YTX.JoinGroupBuilder();
//设置申请群组id
builder.setGroupId(“出彩中国人群组id”);
//设置申请理由
builder.setDeclared(“申请理由”);
//发送请求
RL_YTX.joinGroup(builder, function(){
//操作成功
},function(obj){
//操作失败 
});    

申请加入群组请求通知          

//获取群组id
var groupId = obj.groupId;
//获取群组名称
var groupName = obj.groupName;
//获取申请者id 
var peopleId = obj.member;
//获取申请者名称
var people = (!!obj.memberName)?obj.memberName:obj.member;
//1申请加入群组，2邀请加入群组，3直接加入群组，4解散群组，5退出群组，6踢出群组，7确认申请加入，8确认邀请结果，10管理员修改群组信息，11用户修改群组成员名片
var auditType = obj.auditType;
if(1 == auditType){
//处理申请加入通知
}

同意加入群组

//新建同意加入请求对象
var builder = new RL_YTX.ConfirmJoinGroupBuilder();
//设置群组id
builder.setGroupId(“出彩中国人群组id”);
//设置申请者账号
builder.setMemberId(“Smith账号”);
//设置同意或拒绝 1拒绝 2同意
builder.setConfirm(2);
//发送请求
RL_YTX.confirmJoinGroup(builder, function(){
    //处理成功
    }, function(obj){
    //处理失败
    });

成员加入通知

//获取群组id
var groupId = obj.groupId;
//获取群组名称
var groupName = obj.groupName;
//获取加入者id
var peopleId = obj.member;
//获取加入者名称
var people = (!!obj.memberName)?obj.memberName:obj.member;
//(1申请加入群组，2邀请加入群组，3直接加入群组，4解散群组，5退出群组，6踢出群组，7确认申请加入，8确认邀请结果，10管理员修改群组信息，11用户修改群组成员名片)
var auditType = obj.auditType;
if(7 == auditType){
    //处理某人加入群组通知
    }

邀请加入群组 

//新建邀请加入请求对象
var builder = new RL_YTX.InviteJoinGroupBuilder();
//设置群组id
builder. setGroupId(“出彩中国人群组id”);
//设置邀请成员账号
builder. setMembers([“Smith的账号”]);
//是否需要对方确认（1不需要直接加入，2需要）
var confirm = 2;
builder.setConfirm(confirm);
//发送邀请
RL_YTX.inviteJoinGroup(builder,function(){
//邀请成功
if(confirm == 1){
//更新页面群组成员列表
},function(obj){
//邀请成员失败
})                  

用户验证管理员邀请加入群组            

//获取群组id
var groupId = obj.groupId;
//获取群组名称
var groupName = obj.groupName;
//获取邀请者id
var peopleId = obj.member;
//获取邀请者名称
var people = (!!obj.memberName)?obj.memberName:obj.member;
//(1申请加入群组，2邀请加入群组，3直接加入群组，4解散群组，5退出群组，6踢出群组，7确认申请加入，8确认邀请结果，10管理员修改群组信息，11用户修改群组成员名片)
var auditType = obj.auditType;
if(2 == auditType){
    if(1 == obj.confirm){
        //直接加入群组，更新成员列表
    }else{
        //处理邀请加入群组请求通知
         var builder = new RL_YTX.ConfirmInviteJoinGroupBuilder();
            //设置邀请者id
            builder.setInvitor("邀请者id");
            //设置群组id
            builder.setGroupId(gruopId);
            //1 拒绝，2 同意
            builder.setConfirm(2);
            RL_YTX.confirmInviteJoinGroup(builder, function(e) {
             //处理成功
            }, function(obj){
            //处理失败
            });

邀请加入群组通知

//获取群组id
var groupId = obj.groupId;
//获取群组名称
var groupName = obj.groupName;
//获取加入成员id
var peopleId = obj.member;
//获取加入成员名称
var people = (!!obj.memberName)?obj.memberName:obj.member;
//(1申请加入群组，2邀请加入群组，3直接加入群组，4解散群组，5退出群组，6踢出群组，7确认申请加入，8确认邀请结果，10管理员修改群组信息，11用户修改群组成员名片)
var auditType = obj.auditType;
if(8 == auditType){
if(2 != obj.confirm){
    //拒绝管理员邀请，通知页面
    }else{
    //同意管理员邀请，通知页面
    } 
  }                 

退出群组

//新建退出群组请求对象
var builder = new RL_YTX.QuitGroupBuilder();
//设置群组id
builder.setGroupId(“出彩中国人群组id”);
//发送请求
RL_YTX.quitGroup(builder, function(){
        //退出群组成功
        //更新页面
        }, function(obj){
        //退出群组失败
        });

退出群组通知

//获取群组id
var groupId = obj.groupId;
//获取群组名称
var groupName = obj.groupName;
//获取退出者id
var peopleId = obj.member;
//获取退出者名称
var people = (!!obj.memberName)?obj.memberName:obj.member;
//(1申请加入群组，2邀请加入群组，3直接加入群组，4解散群组，5退出群组，6踢出群组，7确认申请加入，8确认邀请结果，10管理员修改群组信息，11用户修改群组成员名片)
var auditType = obj.auditType;
if(5 == auditType){
    //有用户退出群组，更新列表
    }

群主踢人

//构建踢出用户请求对象
var builder = new RL_YTX.DeleteGroupMemberBuilder(groupId,memberId);
builder.setGroupId(“出彩中国人群组id”);
builder.setMemberId(“Smith账号”);
RL_YTX.deleteGroupMember(builder, function(){
//踢出成功
},function(obj){
//踢出失败
});                

移除成员通知

//获取群组id
var groupId = obj.groupId;
//获取群组名称
var groupName = obj.groupName;
//获取被踢出者id
var peopleId = obj.member;
//被踢出者名称
var people = (!!obj.memberName)?obj.memberName:obj.member;
//(1申请加入群组，2邀请加入群组，3直接加入群组，4解散群组，5退出群组，6踢出群组，7确认申请加入，8确认邀请结果，10管理员修改群组信息，11用户修改群组成员名片)
var auditType = obj.auditType;
if(6 == auditType){
        if(“Smith账号”.equals(“peopleId”)){
        //是自己，更新群组列表
        }else{
        //更新群组成员列表
        }}

解散群组

//构建解散群组消息对象
var obj = new RL_YTX.DismissGroupBuilder();
//设置群组id
obj.setGroupId(“出彩中国人群组id”);
RL_YTX.dismissGroup(obj, function(){
        //解散成功,更新页面
        }, function(obj){
        //解散失败
        });

解散群组通知

//获取群组id
var groupId = obj.groupId;
//获取群组名称
var groupName = obj.groupName;
//获取操作者id
var peopleId = obj.member;
//获取操作者名称
var people = (!!obj.memberName)?obj.memberName:obj.member;
//(1申请加入群组，2邀请加入群组，3直接加入群组，4解散群组，5退出群组，6踢出群组，7确认申请加入，8确认邀请结果，10管理员修改群组信息，11用户修改群组成员名片)
var auditType = obj.auditType;
if(4 == auditType){
//更新页面
}

获取群组成员

//新建获取群组成员列表请求对象
var obj = new RL_YTX.GetGroupMemberListBuilder();
//设置群组id
obj.setGroupId(“出彩中国人群组id”);
//该接口为分页接口，如果要获取全部数据，设置pageSize为-1
obj.setPageSize(-1);
//发送请求
RL_YTX.getGroupMemberList(obj, function(obj){
//成功获取数据，更新页面
}, function(obj){
//获取数据失败
});               

群组搜索

//新建群组搜索请求对象
var builder = new RL_YTX.SearchGroupsBuilder(type,key);
//搜索类型 1 群组id精确查找 2 群组名称模糊搜索
builder.setType(1);
builder.setKeywords(“出彩中国人群组id”);
RL_YTX.searchGroups(builder, function(obj){
       //检索成功
        },function(obj){
       //检索失败
        });                

群组免打扰

//新建设置群组个性化设置对象
var builder = new RL_YTX.SetGroupMessageRuleBuilder();
//设置群组id
builder.setGroupId(“出彩中国人群组id”);
//设置免打扰 1提醒 2免打扰
builder.setIsNotice(2);
RL_YTX.setGroupMessageRule(builder,function(){
//设置免打扰成功
},function(obj){
//设置免打扰失败
});

获取个人所在的群组 

//新建获取群组列表请求对象
var obj = new RL_YTX.GetGroupListBuilder();
//设置获取群组数量，该接口为分页接口，如果要获取全部数据，设置pageSize为-1
obj.setPageSize(-1);
obj.setTarget(2); //获取群组列表。默认为群组列表，如果要获取讨论组列表，该值传1。
RL_YTX.getGroupList(obj, function(obj){
//更新页面
  }, function(obj){
    //获取群组列表失败
  });                             

群主转让功能

/*
 *  转让群组 
 * @groupId  群组ID
 * @member   转让给的成员
 * @role     角色     1转让群主  2 设为管理员   3  取消管理员资格  
 * */
        var roleBuilder = new RL_YTX.SetGroupMemberRoleBuilder();
        roleBuilder.setGroupId(groupId);
        roleBuilder.setMemberId(member);
        roleBuilder.setRole(role);
        RL_YTX.setGroupMemberRole(roleBuilder, function() {
                var trobj = $('#pop').find('tr[contact_you="' + member + '"]');
                var tdobj = trobj.children();
                var spanobj = tdobj.children();
                var deleobj = spanobj[3];
                $(deleobj).remove();
                console.log("修改成员角色成功");
                if (role == 1) {
                        IM.HTML_pop_hide();
                } else if (role == 2) {
                        $(spanobj).eq(0).children("span").text("[管理员]");
                        $(spanobj).eq(2).after(' 取消管理员资格 ');
                } else {
                        $(spanobj).eq(0).children("span").text("[成员]");
                        $(spanobj).eq(2).after(' 设置为管理员 ');
                }
        }, function(obj) {
                alert("错误码： " + obj.code + "; 错误描述：" + obj.msg); 
                     });