SDK接口文档
1.初始化
方法 | RL_YTX.init(appId,webserver,lvsServer,sig) | ||||
参数说明 | 参数名 | 必选 | 说明 | ||
appid | 是 | 应用appid,第三方注册时分配 | |||
webServer 对应serverIp和 file serverIp | 否 | (私有云)WebSocket服务器地址 格式为 ip:port | |||
lvsServer | 否 | (私有云)WebSocket服务器地址 格式为 ip:port | |||
fileSig (sdk中固定) | 否 | (私有云)fileSig规则 MD5(公司ID+公司密码) | |||
返回值 |
2.登陆
方法 | RL_YTX.login(LoginBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
LoginBuilder | 是 | RL_YTX. LoginBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 登录成功回调function callback(obj){ obj.authState; //Kick Off 是否被踢下线 可为空 obj.kickoffText; //Kick Off 被踢下线的提示信息 可为空 obj.connectorId; //鉴权成功后,返回连接器编号 obj.version; //服务器消息最大版本号 obj.pversion; //个人资料版本号 obj.softVersion; //软件最新版本号 obj.historyver; //离线消息开始版本号 obj.authToken; //精简认证Token} | ||
onError | 是 | 登录失败回调function onError(obj){ obj.code //错误码 obj.msg //错误描述} | ||
返回值 | 无 |
3.登出
方法 | RL_YTX.logout(callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
callback | 登录成功回调function callback(){} | |||
onError | 登录失败回调function onError(obj){ obj. code //错误码 | |||
返回值 | 无 |
4.IM消息监听
方法 | RL_YTX. onMsgReceiveListener(callback) | |||
参数说明 | 参数名 | 必选 | 说明 | |
callback | 是 | 通知回调function callback(obj){ obj.msgId; //消息msgId obj.msgType; //消息类型1:文本消息 2:语音消息3:视频消息 4:图片消息 5:位置消息 6:压缩文件7非压缩文件 11群组发送@消息 12 状态消息 //状态消息时obj.msgDomain0 无输入状态 1 正在输入 2 正在录音 obj.msgContent; //文本消息内容 obj.msgSender; //发送者 obj.msgReceiver; //接收者群组Im消息时,接收者为群组id obj.msgDomain; //扩展信息(长度有限制,2048个字符) obj.msgFileName; //消息文件名 obj.msgFileUrl; //消息下载地址 obj.msgFileUrlThum; //视频消息的缩略图url obj.msgDateCreated; //服务器接收消息时间 obj.senderNickName; //发送者昵称(可为空) obj.mcmEvent;//是否MCM消息 0普通消息 1 start消息 2 end消息 53 发送mcm消息 obj.msgFileSize;//附件大小 | ||
返回值 | 无 |
5.指令(群组通知)消息监听
方法 | RL_YTX. onMCMMsgReceiveListener(callback) | |||
参数说明 | 参数名 | 必选 | 说明 | |
callback | 是 | 通知回调function callback(obj){ obj.msgId; //消息msgId obj.msgType; //消息类型1:文本消息 2:语音消息 3:视频消息 4:图片消息 obj.msgContent; //文本消息内容 obj.msgSender; //发送者 obj.msgReceiver; //接收者群组Im消息时,接收者为群组id obj.msgDomain; //扩展信息 obj.msgFileName; //消息文件名 obj.msgFileUrl; //消息下载地址 obj.msgDateCreated; //服务器接收消息时间 obj.senderNickName; //发送者昵称 obj.mcmEvent; //mcm消息类型 1 start消息 2 end消息 3发送mcm消息 obj.msgFileSize;//附件大小} | ||
返回值 | 无 |
6. 连接状态变更
方法 | RL_YTX. onConnectStateChangeLisenter(callback) | |||
参数说明 | 参数名 | 必选 | 说明 | |
callback | 是 | 通知回调function callback(obj){ obj.code;//变更状态 1 断开连接 2 重练中 3 重练成功 4 被踢下线 obj.msg;//消息提示} | ||
返回值 | 无 |
7.获取个人信息
方法 | RL_YTX. getMyInfo(callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
callback | 是 | 成功回调function callback(obj){obj.version; //个人信息版本号 obj.sex; //性别 1男(默认) 2女 obj.birth; //生日 格式 2015-12-31} | ||
onError | 是 | 失败回调function onError(obj){ obj. code //错误码 obj.msg //错误描述} | ||
返回值 | 无 |
8.设置个人信息
方法 | RL_YTX.uploadPersonInfo(uploadPersonInfoBuilder,callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
UploadPersonInfoBuilder | 是 | RL_YTX.UploadPersonInfoBuilder对象 参考附录中 发送请求参数说明 | ||
callback | 是 | 成功回调function callback(obj){ obj.version; //个人信息版本号} | ||
onError | 失败回调function onError(obj){ obj. code //错误码 obj.msg //错误描述} | |||
返回值 | 无 |
9.发消息
方法 | RL_YTX.sendMsg(MsgBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
MsgBuilder | 是 | RL_YTX. MsgBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(obj){obj.msgId; // obj.msgClientNo // SDK生成的发送者消息id} | ||
onError | 是 | 成功回调function callback(obj){ obj.msgId; //客户传入消息msgId(已废弃) obj.msgClientNo // SDK生成的发送者消息id} | ||
progress | 否 | 发送附件时的上传进度回调 total;//总字节数msgClientNo;// SDK生成的 | ||
返回值 | msgClientNo //SDK生成的发送者消息id |
10.创建群组
方法 | RL_YTX. createGroup(CreateGroupBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
CreateGroupBuilder | 是 | RL_YTX. CreateGroupBuilder对象 参考附录中 发送请求参数说明 | ||
callback | 是 | 成功回调function callback(obj){ obj.data;//群组groupId} | ||
onError | 是 | 失败回调function onError(obj){ obj. code //错误码 obj.msg //错误描述} | ||
返回值 | 无 |
11.解散群组
方法 | RL_YTX. dismissGroup(DismissGroupBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
DismissGroupBuilder | 是 | RL_YTX. DismissGroupBuilder对象 参考附录中发送请求 参数说明 | ||
callback | 是 | 成功回调function callback(){} | ||
onError | 是 | 失败回调function onError(obj){ obj. code //错误码 obj.msg //错误描述} | ||
返回值 | 无 |
12.邀请用户加入群组
方法 | RL_YTX. inviteJoinGroup(InviteJoinGroupBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
InviteJoinGroupBuilder | 是 | RL_YTX. InviteJoinGroupBuilder对象 参考附录中 发送请求参数说明 | ||
callback | 是 | 邀请成功回调function callback(){} | ||
onError | 是 | 邀请失败回调function onError(obj){obj. code //错误码 obj.msg //错误描述} | ||
返回值 | 无 |
13.处理群组邀请
方法 | RL_YTX. confirmInviteJoinGroup(ConfirmInviteJoinGroupBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
ConfirmInviteJoinGroupBuilder | 是 | RL_YTX. ConfirmInviteJoinGroupBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 处理成功回调function callback(){} | ||
onError | 是 | 处理失败回调function onError(obj){obj. code //错误码obj.msg //错误描述} | ||
返回值 | 无 |
14.申请加入群组
方法 | RL_YTX. joinGroup(JoinGroupBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
JoinGroupBuilder | 是 | RL_YTX. JoinGroupBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(){} | ||
onError | 是 | 失败回调function onError(obj){obj. code //错误码obj.msg //错误描述} | ||
返回值 | 无 |
15.处理加入申请
方法 | RL_YTX. confirmJoinGroup(ConfirmJoinGroupBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
ConfirmJoinGroupBuilder | 是 | RL_YTX. ConfirmJoinGroupBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(){} | ||
onError | 是 | 失败回调function onError(obj){obj. code //错误码obj.msg //错误描述} | ||
返回值 | 无 |
16.退出群组
方法 | RL_YTX. quitGroup(QuitGroupBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
QuitGroupBuilder | 是 | RL_YTX. QuitGroupBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(){} | ||
onError | 是 | 失败回调function onError(obj){obj. code //错误码obj.msg //错误描述} | ||
返回值 | 无 |
17.修改群组成员角色
方法 | RL_YTX.setGroupMemberRole(SetGroupMemberRoleBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
RL_YTX.SetGroupMemberRoleBuilder | 是 | SetGroupMemberRoleBuilder.setGroupId //当前群组 IDSetGroupMemberRoleBuilder.setMemberId //当前成员IDSetGroupMemberRoleBuilder.setRole //设置角色id:1转让群主 2 设为管理员 3 取消管理员资格 | ||
callback | 是 | 成功回调function callback(){} | ||
onError | 是 | 失败回调function onError(obj){obj. code //错误码obj.msg //错误描述} | ||
返回值 | 无 |
18.踢出群组成员
方法 | RL_YTX. deleteGroupMember(DeleteGroupMemberBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
DeleteGroupMemberBuilder | 是 | RL_YTX. DeleteGroupMemberBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(){} | ||
onError | 是 | 失败回调function onError(obj){obj. code //错误码obj.msg //错误描述} | ||
返回值 | 无 |
19.分页获取群组列表(登陆成功后调用)
方法 | RL_YTX. getGroupList(GetGroupListBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
GetGroupListBuilder | 是 | RL_YTX. GetGroupListBuilder对象 参考附录中发送 请求参数说明 | ||
callback | 是 | 成功回调function callback(obj){ for(var i in obj){//群组列表数组 }} | ||
onError | 是 | 失败回调function onError(obj){obj. code //错误码 obj.msg //错误描述} | ||
返回值 | 无 |
20.分页获取群组成员
方法 | RL_YTX. getGroupMemberList(GetGroupMemberListBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
GetGroupMemberListBuilder | 是 | RL_YTX. GetGroupMemberListBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(obj){ for(var i in obj){ var member = obj[i];//群组成员列表 cmember.member;//成员id member.nickName;//昵称 member.speakState;//禁言状态 1:不禁言 2:禁言 member.role;//角色 1:创建者2:管理员3:成员 member.sex;//性别 1:男 2:女 }} | ||
onError | 是 | 失败回调function onError(obj){ obj. code //错误码 obj.msg //错误描述} | ||
返回值 | 无 |
21.群组成员禁言
方法 | RL_YTX. forbidMemberSpeak(ForbidMemberSpeakBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
ForbidMemberSpeakBuilder | 是 | RL_YTX. ForbidMemberSpeakBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(){} | ||
onError | 是 | 失败回调function onError(obj){ obj. code //错误码obj.msg //错误描述} | ||
返回值 | 无 |
22.获取群组成员名片
方法 | RL_YTX. queryGroupMemberCard(QueryGroupMemberCardBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
QueryGroupMemberCardBuilder | 是 | RL_YTX.QueryGroupMemberCardBuilder 对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(obj){ Obj.member; //成员id obj.groupid; //群组id obj.display; //成员昵称 obj.phone; //成员手机号 obj.mail; //成员邮箱 obj.remark; //成员备注 obj.speakState;//成员禁言状态1:未禁言2:禁言 obj.role; //成员角色 1:创建者2:管理员3成员 obj.sex; //成员性别 1:男 2:女} | ||
onError | 是 | 失败回调function onError(obj){obj. code //错误码obj.msg //错误描述} | ||
返回值 | 无 |
23.修改群组成员名片
方法 | RL_YTX. modifyMemberCard (ModifyMemberCardBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
ModifyMemberCardBuilder | 是 | RL_YTX. ModifyMemberCardBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(){} | ||
onError | 是 | 失败回调function onError(obj){ obj. code /错误码 obj.msg //错误描述} | ||
返回值 | 无 |
24.搜索群组
方法 | RL_YTX. searchGroups(SearchGroupsBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
SearchGroupsBuilder | 是 | RL_YTX. SearchGroupsBuilder对象 参考附录中 发送请求参数说明 | ||
callback | 是 | 成功回调function callback(obj){ for(var i in obj){//群组列表 var simple = obj[i]; }} | ||
onError | 是 | 失败回调function onError(obj){ obj. code //错误码 obj.msg //错误描述} | ||
返回值 | 无 |
25.获取群组详情
方法 | RL_YTX. getGroupDetail(GetGroupDetailBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
GetGroupDetailBuilder | 是 | RL_YTX. GetGroupDetailBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(obj){ obj.creator; //创建者 obj.groupName; //群组名称 obj.type; //群组类型 obj.province; //省份 obj.city; //城市 obj.scope; //群组大小 obj.declared; //群组公告 obj.dateCreated; //创建时间 obj.numbers; //群组人数 obj.isNotice; //是否免打扰 obj.permission; //群组权限 Obj.target //群组类型,1是讨论组 2是群组 obj.groupDomain; //扩展信息 obj.isApplePush; //是否苹果离线推送 obj.target;//群组模式 1讨论组 2普通群组} | ||
onError | 是 | 失败回调function onError(obj){ obj. code //错误码 obj.msg //错误描述} | ||
返回值 | 无 |
26.修改群组详情
方法 | RL_YTX. modifyGroup(ModifyGroupBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
ModifyGroupBuilder | 是 | RL_YTX. ModifyGroupBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(){} | ||
onError | 是 | 失败回调function onError(obj){obj. code //错误码obj.msg //错误描述} | ||
返回值 | 无 |
27.群组消息推送设置(免打扰)
方法 | RL_YTX.setGroupMessageRule(SetGroupMessageRuleBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
SetGroupMessageRuleBuilder | 是 | RL_YTX. SetGroupMessageRuleBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(){} | ||
onError | 是 | 失败回调function onError(obj){ obj. code //错误码 obj.msg //错误描述} | ||
返回值 | 无 |
28.解压缩GZIP附件url
方法 | RL_YTX.setGroupMessageRule(SetGroupMessageRuleBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
SetGroupMessageRuleBuilder | 是 | RL_YTX. SetGroupMessageRuleBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(){} | ||
onError | 是 | 失败回调function onError(obj){obj. code //错误码obj.msg //错误描述} | ||
返回值 | 无 |
29.获取用户在线状态
方法 | RL_YTX. getUserState(GetUserStateBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
GetUserStateBuilder | 是 | getUserStateBuilder.setNewUserstate(true); getUserStateBuilder.setUseracc(contact_you); | ||
callback | 是 | 成功回调 function callback(obj){ obj[i].useracc;//用户账号 obj[i].state;//在线状态 1:在线 2:离线 obj[i].network;//被查询人员的网络状态 obj[i].device;//终端类型 1:Android 2:iPhone 10:iPad } | ||
onError | 是 | 失败回调function onError(obj){ obj. code //错误码 obj.msg //错误描述} | ||
返回值 | 无 |
30.删除消息
方法 | RL_YTX.deleteReadMsg(DeleteReadMsgBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
DeleteReadMsgBuilder | 是 | RL_YTX. DeleteReadMsgBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(){} | ||
onError | 是 | 失败回调function onError(obj){obj. code //错误码obj.msg //错误描述} | ||
返回值 | 无 |
31.(阅后即焚)立即删除消息通知
方法 | RL_YTX.onMsgNotifyReceiveListener(callback) | |||
参数说明 | 参数名 | 必选 | 说明 | |
callback | 是 | 成功回调function callback(obj){ obj.msgType;//消息类型 obj.sender;//删除操作者 obj.msgId;//消息id obj.dateCreated;//创建时间} | ||
返回值 | 无 |
32.消息撤回
方法 | RL_YTX. msgBack (MsgBackBuilder,callback,onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
MsgBackBuilder | RL_YTX.MsgBackBuilder对象 参考附录中发送请求参数说明 | |||
callback | 操作状态码 200表示成功 | |||
onError | 失败回调function onError(obj){ obj. code //错误码 obj.msg //错误描述} | |||
返回值 | 无 |
33.消息已读
方法 | RL_YTX. msgBack (MsgReadBuilder,callbacsk,onError) | |||
参数说明 | 参数名 | 必选 | 参数名 | |
MsgReadBuilder | 是 | RL_YTX.MsgReadBuilder对象 参考附录中发送 请求参数说明 | ||
callback | 是 | 操作状态码 200表示成功,其他为失败 | ||
onError | 是 | 失败回调function onError(obj){ obj. code //错误码 obj.msg //错误描述} | ||
返回值 | 无 |
34.日志关闭
方法 | RL_YTX.setLogClose() |
返回值 | 无 |
35.设置音视频展示标签
方法 | RL_YTX.setCallView(view,localView) | |||
参数说明 | 参数名 | 必选 | 说明 | |
view | 是 | 对方视频展示的HTML标签 | ||
localView | 是 | 本地视频展示的HTML标签 | ||
备注 | 发起或接受音视频消息前需要调用该接口 |
36.发送音视频请求
方法 | RL_YTX.makeCall(MakeCallBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
MakeCallBuilder | 是 | RL_YTX.MakeCallBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(){} | ||
onError | 是 | 失败回调function onError(obj){obj. code //错误码obj.msg //错误描述} | ||
返回值 | 无 |
37.接收音视频请求
方法 | RL_YTX.accetpCall(AcceptCallBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
AcceptCallBuilder | 是 | RL_YTX.AcceptCallBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(){} | ||
onError | 是 | 失败回调function onError(obj){obj. code //错误码obj.msg //错误描述} | ||
返回值 | 无 |
38.拒绝音视频请求
方法 | RL_YTX.rejectCall(RejectCallBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
RejectCallBuilder | 是 | RL_YTX.RejectCallBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(){} | ||
onError | 是 | 失败回调function onError(obj){obj. code //错误码} | ||
返回值 | 无 |
39.取消音视频
方法 | RL_YTX.releaseCall(ReleaseCallBuilder, callback, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
ReleaseCallBuilder | 是 | RL_YTX.ReleaseCallBuilder对象 参考附录中发送请求参数说明 | ||
callback | 是 | 成功回调function callback(){} | ||
1) onError | 是 | 失败回调function onError(obj){obj. code //错误码obj.msg //错误描述} | ||
返回值 | 无 |
40.音视频消息通知
方法 | RL_YTX.onCallMsgListener(callback) | |||
参数说明 | 参数名 | 必选 | 说明 | |
callback | 是 | function(obj){ obj.callId; obj.caller; obj.called; obj.callType;//0 音频 1 视频 obj.userdata;//自定义参数 obj.state;//1 对方振铃 2 呼叫中 3 被叫接受 4 呼叫失败 5 结束通话 6有新的呼叫 obj.reason;//失败原因 obj.code;//状态码 200为成功,其他表示因本地原因无法接受音视频请求(例如不支持音视频),具体原因请参照错误码} |
41.准备拍照
方法 | RL_YTX.photo.apply(obj, onCanPlay, onError) | |||
参数说明 | 参数名 | 必选 | 说明 | |
obj | 是 | Object对象,obj.tag DOM对象,表示预览图片的video标签 | ||
onCanPlay | 否 | 媒体流准备就绪,可以进行拍照的通知回调function onCanPlay(){} | ||
onError | 是 | 失败回调function onError(obj){ obj.code; //错误码 obj.msg; //错误信息} |
42.拍照
方法 | RL_YTX.photo.make() | ||||
返回值 | 参数名 | 必选 | 说明 | ||
obj | obj.code | 否 | 操作状态码 200表示成功,其他为失败 | ||
obj.blob | 否 | 拍照成功返回的blob对象 | |||
obj.msg | 否 | 操作失败的错误信息 |
43.取消拍照
方法 | RL_YTX.photo. cancel() | |||
返回值 | 参数名 | 必选 | 说明 | |
obj | obj.code | 是 | 操作状态码 200表示成功,其他为失败 |
44.录制视频
方法 | RL_YTX. VideoRecord (stream,isVideo) | |||
参数说明 | 参数名 | 必选 | 说明 | |
stream | 是 | 录制本地或者远端视频,录制本地视频参数为”local”,远端视频为”remote” | ||
isVideo | 否 | 是否录制视频,默认为false,即录制音频,true为录制视频。 | ||
return | 是 | 录制本地或者远端视频,录制本地视频参数为”local”,远端视频为”remote” | ||
返回值 | 如果不支持录制则返回{err: 174012, msg:"do not support record"}; 如果支持,返回值为一个record对象, 对象有start开始录制、stop(callback)停止录制、pause暂停录制、resume继续录制 |
45.切换摄像头
方法 | RL_YTX. exchangeCamera (cameraId,callback,onerror) | |||
参数说明 | 参数名 | 必选 | 说明 | |
cameraId | 是 | 摄像头id,可通过RL_YTX.getDevices获取 | ||
callback | 否 | 成功回调 | ||
return | 失败回调function onError(obj){obj. code //错误码obj.msg //错误描述} | |||
返回值 |
46.设置摄像头/麦克风
方法 | RL_YTX. deployVideoVoice (enable , type) | |||
参数说明 | 参数名 | 必选 | 说明 | |
enable | 是 | true为开启,false为关闭 | ||
type | 是 | 设备类型,”video”为摄像头,”audio”为麦克风 | ||
返回值 | void | 无 |
47.附录
对象 | 属性值 | |||
属性名 | 必选 | 说明 | 备注 | |
RL_YTX. LoginBuilder | type | 是 | 1:完整帐号登录 2:精简认证 3:voip帐号密码登录 | 当为voip登录方式时,pwd为必选字段,且sig字段可不传 |
userName | 是 | 用户账号或voip账号 | ||
pwd | 否 | Voip密码 | ||
sig | 是 | 登录sig值,由页面请求第三方 服务器生成,格式: MD5(appid+userName+ timestamp+ apptoken), timestamp格式:yyyyMMddHHmmss | ||
timestamp | 是 | 登录时间戳 yyyyMMddHHmmss格式, 和sig中的时间戳一致 | ||
RL_YTX. MsgBuilder | id | 否 | (废弃,兼容老版本) | text和file属性最少有一个有值 |
text | 否 | 发送消息内容 | ||
file | 否 | 发送图片或附件时的文件对象 | ||
type | 是 | 发送消息类型 1文本消息 2 语音消息 3 视频消息 4 图片消息 5 位置消息 6 压缩文件消息 7非压缩文件消息 11群组@消息 12状态消息 | ||
receiver | 是 | 消息接收者 | ||
domain | 否 | 自定义属性 | ||
fileName | 否 | 文件名称 | ||
RL_YTX.CreateGroup Builder | groupName | 是 | 群组名称 | |
groupType | 否 | 1: 同学 2: 朋友 3: 同事 默认1 | ||
province | 否 | 群组省份 | ||
city | 否 | 群组城市 | ||
scope | 否 | 群组人数范围 1 100人 2 300人 3 500人 4 1000人 5 2000人 默认为1 | ||
declared | 否 | 群组描述 | ||
permission | 否 | 群组权限 必选 1:默认可直接加入 2:需要身份验证 3:私有群组(不能主动加入, 仅能管理员邀请) 默认为1 | ||
mode | 否 | 创建者退出,群组是否解散 必选 1: 不解散 2: 解散 默认1 | ||
groupDomain | 否 | 扩展信息 | ||
target | 否 | 1 讨论组 2 普通群组 默认为2 | ||
RL_YTX.Dismiss GroupBuilder | groupId | 是 | 群组id | |
RL_YTX.InviteJoin GroupBuilder | groupId | 是 | 群组id | members参数必须为数组 |
declared | 否 | 邀请理由 | ||
members | 是 | 邀请成员 | ||
confirm | 否 | 是否需要邀请者确认 1 不需要 2 需要 默认为2 | ||
RL_YTX.ConfirmInvite JoinGroupBuilder | invitor | 是 | 邀请者 | |
groupId | 是 | 群组id | ||
confirm | 否 | 是否同意邀请 1 不同意 2同意 默认为1 | ||
RL_YTX.Quit GroupBuilder | groupid | 是 | 群组id | |
RL_YTX.GetGroup ListBuilder | groupId | 否 | 起始群组id | |
pageSize | 否 | 群组分页大小默认50 | ||
target | 否 | 群组模式 -1 全部 1讨论 2群组 | ||
RL_YTX.GetGroup MemberListBuilder | groupId | 是 | 群组id | |
memberId | 否 | 起始群组成员id | ||
pageSize | 否 | 成员分页大小 默认50 | ||
RL_YTX.JoinGroup Builder | groupId | 是 | 群组id | |
declared | 否 | 申请理由 | ||
RL_YTX.Confirm JoinGroupBuilder | groupId | 是 | 群组id | |
memberId | 是 | 申请者id | ||
confirm | 是 | 是否同意1不同意 2同意 | ||
RL_YTX.GetGroup DetailBuilder | groupId | 是 | 群组id | |
RL_YTX.Search GroupsBuilder | searchType | 是 | 搜索类型 1群组id精确查找 2群组名称模糊搜索 | |
keywords | 是 | 搜索关键字 | ||
RL_YTX.DeleteGroup MemberBuilder | groupId | 是 | 群组id | |
memberId | 是 | 成员id | ||
RL_YTX.ForbidMember SpeakBuilder | groupId | 是 | 群组id | |
memberId | 是 | 成员id | ||
forbidState | 否 | 禁言状态 1正常 2禁言 默认为2 | ||
RL_YTX.SetGroup MessageRuleBuilder | groupId | 是 | 群组id | |
isNotice | 否 | 是否免打扰 1提醒 2免打扰 | ||
isApplePush | 否 | 苹果设备离线是否离线推送 1 推送 2 不推送 | ||
RL_YTX.QueryGroup MemberCardBuilder | memberId | 是 | 成员id | |
belong | 是 | 群组id | ||
RL_YTX.Modify MemberCardBuilder* | member | 是 | 成员id | |
belong | 是 | 群组id | ||
display | 否 | 修改后的昵称 | ||
phone | 否 | 修改后的手机号 | ||
否 | 修改后的邮箱 | |||
remark | 否 | 修改后的备注 | ||
RL_YTX.Modify GroupBuilder | groupId | 是 | 群组id | |
groupName | 是 | 群组名称 | ||
type | 否 | 群组类型 1: 同学 2: 朋友 3: 同事 | ||
province | 否 | 群组省份 | ||
city | 否 | 群组城市 | ||
declared | 否 | 群组公告 | ||
permission | 否 | 群组权限 1:默认可直接加入 2:需要身份验证 3:私有群组(不能主动加入,仅能管理员邀请) | ||
groupDomain | 否 | 自定义字段 | ||
RL_YTX.AttachMsg Builder | id | 是 | 客户端消息id | |
file | 是 | 需要发送的附件,为HTML5中的File对象, 获取方式可参考附录中: 发送附件时file对象获取 | ||
type | 是 | 附件类型。 2语音消息 3 视频消息 4图片消息 5 位置消息 6文件消息 | ||
receiver | 是 | 消息接收者 | ||
domain | 否 | 自定义属性 | ||
sendType | 否 | 发送类型 1 IM消息 2多渠道消息 默认为1 | ||
RL_YTX. DeskMessage StartBuilder | osUnityAccount | 是 | 客服号 | |
userData | 否 | 自定义字段 | ||
RL_YTX. Desk MessageBuilder | content | 是 | 发送内容 | content和file对象最少有一个有值 |
file | 是 | 需要发送的附件,为HTML5中的 File对象,获取方式可参考附录中: 发送附件时file对象获取 | ||
type | 是 | 附件类型。 2语音消息 3 视频消息 4图片消息 5 位置消息 6文件消息 | ||
userData | 是 | 用户自定义属性 | ||
osUnityAccount | 否 | 客服号 | ||
msgId | 否 | (废弃,兼容老版本) | ||
fileName | 否 | 文件名称 | ||
RL_YTX. DeskMessage StopBuilder | osUnityAccount | 是 | 客服号 | |
userData | 否 | 自定义字段 | ||
RL_YTX.Upload PersonInfoBuilder | nickName | 是 | 用户昵称 | |
sex | 否 | 用户性别 1:男 2:女 默认为1 | ||
birth | 否 | 用户生日 yyyy-MM-dd格式 | ||
Sign | 否 | 用户签名,最大100个汉字 | ||
RL_YTX.GetUser StateBuilder | useracc | 是 | 查询用户账号;查询单个可以传 字符串或数组,多个必须是数组 | |
newUserstate | 是 | 是否是多个用户状态 | ||
RL_YTX.MakeCallBuilder | called | 是 | 被叫账号或手机号 | |
callType | 是 | 呼叫类型 0 音频 1 音视频 2 落地电话 | ||
tel | 否 | 落地电话透传显示的号码 | ||
nickname | 否 | 落地电话透传显示的昵称 | ||
RL_YTX.Accept CallBuilder | voipCallId | 是 | 请求的callId | |
caller | 是 | 请求主叫号码 | ||
voipCallId | 是 | 请求的callId | ||
caller | 是 | 请求主叫号码 | ||
RL_YTX.ReleaseCallBuilder | voipCallId | 是 | 请求的callId | |
caller | 是 | 请求主叫号码 | ||
called | 是 | 请求被叫号码 | ||
DeleteReadMsgBuilder | msgid | 是 | 消息接受者收到的msgid | |
GetRecent ContactListBuilder | time | 否 | 获取当前时间和指定时间之间的数据,默认7天 | |
limit | 否 | 获取联系人数量,默认50 最大100 | ||
RL_YTX.GetHistory MessageBuilder | talker | 是 | 消息交互者,群组消息时为群组id | |
pageSize | 否 | 获取消息数量,默认为10,最大为50 | ||
operator | 是 | 操作者在msgId对应的消息中所处的身份 1 消息接受者 2 消息发送者 | ||
msgId | 是 | 消息msgId | ||
order | 否 | 排序方式 | ||
RL_YTX.MCMMessage Builder | content | 否 | 文本内容,该参数和file参数必须二选一 | |
file | 否 | 附件内容,该参数和content参数必须二选一 | ||
msgType | 是 | 消息的类型 | ||
userData | 否 | 用户的自定义参数 | ||
account | 是 | 当前客服的账号 | ||
msgId | 否 | 消息的id | ||
fileName | 否 | 附件的名称 | ||
chanType | 是 | 0及时消息、1微信、2邮件、3短信、4传真 | ||
mailTitle | 否 | 邮件标题;type值为2时有效 | ||
RL_YTX.MCMDataBuilder | ccpCustomData | 是 | 和用户账号一起推送过来的ccpCustomData属性,是mcm平台自定义数据 | |
RL_YTX.SetGroup MemberRoleBuilder | groupId | 是 | 群组或讨论组的id | |
memberId | 是 | 被修改的成员的id | ||
role | 是 | 角色:1创建者 2管理员 3成员 | ||
RL_YTX.Msg OperationBuilder | version | 是 | 要执行操作的消息ID | |
type | 是 | 空:阅后即焚,1:消息撤回,2:消息送达,3:消息已读 | ||
version | 是 | 此msgid是精简的消息版本号 | ||
msgId | 是 | 此msgid是完整的消息版本号,是sendMsg后返回的msgId, | ||
msgId | 是 | 此msgid是完整的消息版本号,是sendMsg后返回的msgId, | ||
RL_YTX. MsgBackBuilder | msgId | 是 | 此msgid是完整的消息版本号,是sendMsg后返回的msgId, | |