音视频通话

API

模块

房间外接口
基础函数
登录/注销
透明通道
队列管理
呼叫
邀请
房间管理
房间内接口
进出房间
房间和成员管理
房间属性
用户属性
音频管理
视频管理
影音共享
屏幕共享
本地录制/本地直播
云端录制/互动直播

基础函数

方式 接口 描述
主调
getSDKVersion 获取原生SDK版本号
init SDK初始化
uninit SDK反初始化
setServerAddr 设置服务器地址

登录/注销

方式 接口 描述
主调
login 登录
updateToken 更新Token
logout 注销
getUserAuthErrCode 获取第三方鉴权失败码
getUserAuthErrDesc 获取第三方鉴权失败原因描述
setDNDStatus 设置免打扰
getUserStatus 获取本AppID下的登录用户的状态信息
startUserStatusNotify 开启AppID下的用户登录状态消息推送
stopUserStatusNotify 关闭appID下的用户在线状态消息推送
回调
loginSuccess 登陆成功的通知
loginFail 登录失败的通知
notifyTokenWillExpire Token即将失效的通知
lineOff 通知自己掉线
setDNDStatusSuccess 设置免打扰成功的通知
setDNDStatusFail 设置免打扰失败的通知
getUserStatusRslt 获取用户登录状态信息的结果
startStatusPushRslt 开启用户状态通知结果
stopStatusPushRslt 关闭用户状态通知结果
notifyUserStatus 通知某用户登录状态变化

透明通道

方式 接口 描述
主调
sendCmd 发送点对点消息
sendBuffer 发送点对点大数据
sendFile 发送点对点文件
cancelSend 取消大数据、文件的发送
回调
sendCmdRslt 发送点对点消息结果
sendBufferRslt 发送点对点大数据结果
sendFileRslt 发送点对点文件结果
cancelSendRslt 取消发送结果
notifySendProgress 通知大数据、文件的发送进度
notifyCmdData 通知收到点对点透明通道消息
notifyBufferData 通知收到点对点大数据
notifyFileData 通知收到点对点文件

队列管理

方式 接口 描述
主调
initQueue 初始化用户队列功能数据
getAllQueueInfo 获取AppID下的所有队列基础信息
getQueueStatus 获取指定队列的排队状况
getQueuingInfo 获取我的排队信息
getServiceQueues 获取我服务的所有队列
getSessionInfo 获取我的会话信息
startQueuing 客户开始排队
stopQueuing 客户停止排队
startService 座席开始服务某队列
stopService 座席停止服务某队列
reqAssignUser 座席手动分配客户
acceptAssignUser 接受系统自动分配的客户
rejectAssignUser 拒绝系统自动分配的客户
回调
initQueueDatRslt 初始化队列功能结果
queueStatusChanged 队列排队状态更新
queuingInfoChanged 我的排队信息更新
startQueuingRslt 客户开始排队结果
stopQueuingRslt 客户停止排队结果
startServiceRslt 座席开始服务结果
stopServiceRslt 座席停止服务结果
responseAssignUserRslt 响应分配客户操作结果
autoAssignUser 座席自动分配客户通知
reqAssignUserRslt 座席手动分配客户结果
cancelAssignUser 通知分配的客户取消了

呼叫

方式 接口 描述
主调
call 发起呼叫
acceptCall 接受他人的呼叫
rejectCall 拒接他人的呼叫
hangupCall 挂断通话
callMoreParty 发起多方呼叫(或呼转)
cancelCallMoreParty 取消多方呼叫
回调
callRslt 发起的呼叫结果
acceptCallRslt 接受他人呼叫的结果
rejectCallRslt 拒绝他人呼叫的结果
hangupCallRslt 挂断通话结果
notifyCallIn 通知呼入
notifyCallAccepted 通知呼叫被接受
notifyCallRejected 通知呼叫被拒接
notifyCallHungup 通知呼叫被挂断
callMorePartyRslt 发起多方呼叫结果
cancelCallMorePartyRslt 取消多方呼叫结果
notifyCallMorePartyStatus 通知多方呼叫状态

邀请

方式 接口 描述
主调
invite 发送邀请
acceptInvite 接受邀请
rejectInvite 拒接邀请
cancelInvite 取消邀请
回调
inviteRslt 邀请他人结果
acceptInviteRslt 接受邀请结果
rejectInviteRslt 拒接邀请结果
cancelInviteRslt 取消邀请结果
notifyInviteIn 通知收到邀请
notifyInviteAccepted 通知邀请被接受
notifyInviteRejected 通知邀请被拒接
notifyInviteCanceled 通知邀请被取消

房间管理

方式 接口 描述
主调
createMeeting 创建房间
destroyMeeting 销毁房间
回调
createMeetingSuccess 通知创建房间成功
createMeetingFail 通知创建房间失败
destroyMeetingRslt 销毁房间响应

进出房间

方式 接口 描述
主调
enterMeeting 进入房间
exitMeeting 离开房间
kickout 将房间内指定成员踢出房间
回调
enterMeetingRslt 进入房间结果
userEnterMeeting 有人进入房间通知
userLeftMeeting 有人离开房间通知
kickoutRslt 踢人的结果通知
meetingDropped 通知从房间里掉线了
meetingStopped 通知房间已被结束

房间和成员管理

方式 接口 描述
主调
getAllMembers 获取房间所有成员信息列表
getMemberInfo 获取单个成员信息
sendMeetingCustomMsg 房间内发送广播消息
回调
notifyNickNameChanged SDK通知某用户改变了昵称
sendMeetingCustomMsgRslt 通知发送房间内自定义广播消息结果
notifyMeetingCustomMsg 通知接收到房间内用户自定义广播
netStateChanged 通知我的网络变化

房间属性

方式 接口 描述
主调
getMeetingAllAttrs 获取所有房间属性
getMeetingAttrs 获取部份房间属性
setMeetingAttrs 重置所有房间属性
addOrUpdateMeetingAttrs 添加或更新房间属性
delMeetingAttrs 删除房间属性
clearMeetingAttrs 清空所有房间属性
回调
getMeetingAllAttrsSuccess 获取所有房间属性成功
getMeetingAllAttrsFail 获取所有房间属性失败
getMeetingAttrsSuccess 获取部份房间属性成功
getMeetingAttrsFail 获取部份房间属性失败
setMeetingAttrsRslt 重置所有房间属性结果
addOrUpdateMeetingAttrsRslt 添加或更新房间属性结果
delMeetingAttrsRslt 删除房间属性结果
clearMeetingAttrsRslt 清空所有房间属性结果
notifyMeetingAttrsChanged 通知房间属性改变

用户属性

方式 接口 描述
主调
getUserAttrs 获取指定用户的属性
setUserAttrs 重置指定用户的属性
addOrUpdateUserAttrs 添加或更新指定用户的属性
delUserAttrs 删除指定用户的属性
clearUserAttrs 清空指定用户的属性
clearAllUserAttrs 清空所有用户的属性
回调
getUserAttrsSuccess 获取指定用户的所有属性成功
getUserAttrsFail 获取指定用户的所有属性失败
setUserAttrsRslt 重置指定用户的属性结果
addOrUpdateUserAttrsRslt 添加或更新指定用户的属性结果
delUserAttrsRslt 删除指定用户的属性结果
clearUserAttrsRslt 清空指定用户的属性结果
clearAllUserAttrsRslt 清空所有用户的属性结果
notifyUserAttrsChanged 通知用户属性改变

音频管理

方式 接口 描述
主调
openMic 打开麦克风
closeMic 关闭麦克风
setAllAudioClose 关闭所有人的麦克风
getAudioCfg 获取音频参数
setAudioCfg 设置音频参数
getSpeakerVolume 获取本地扬声器音量
setSpeakerVolume 设置本地扬声器音量
getSpeakerOut 获取当前是否外放
setSpeakerOut 设置是否外放
startGetAudioPCM 开始获取语音pcm数据
stopGetAudioPCM 停止获取语音pcm数据
回调
audioStatusChanged 通知用户音频状态变化
micEnergyUpdate 通知成员麦克风声音能量变化
notifyAudioPCMData 通知语音PCM数据

视频管理

方式 接口 描述
主调
openVideo 打开摄像头
closeVideo 关闭摄像头
getMyVideoPosition 获取前后置摄像头ID
getVideoCfg 获取设置的摄像头参数
setVideoCfg 设置摄像头参数
getVideoEffects 获取视频效果配置
setVideoEffects 设置视频效果配置
getDefaultVideo 获取指定用户的默认摄像头
setDefaultVideo 设置默认的摄像头
getLocVideoAttributes 获取某个摄像头私有属性
setLocVideoAttributes 设置某个摄像头私有属性
getWatchableVideos 获取房间内所有可观看的摄像头
getAllVideoInfo 获取摄像头设备列表
回调
videoStatusChanged 通知用户视频状态变化
openVideoRslt 打开摄像头设备操作结果
videoDevChanged 通知用户的视频设备有变化

影音共享

方式 接口 描述
主调
getMediaCfg 获取影音共享配置参数
setMediaCfg 配置影音共享图像质量参数
startPlayMedia 播放影音文件
pausePlayMedia 暂停或恢复播放影音
stopPlayMedia 停止影音播放
setMediaPlayPos 设置播放进度
getMediaInfo 查询当前影音共享状态
回调
notifyMediaOpened 通知影音文件打开
notifyMediaStart 收到他人开启了影音共享的通知
notifyMediaPause 收到他人暂停了影音共享的通知
notifyMediaStop 收到他人停止了影音共享的通知

屏幕共享

方式 接口 描述
主调
getScreenShareCfg 获取屏幕共享配置
setScreenShareCfg 设置本地屏幕共享配置
startScreenShare 开启屏幕共享
stopScreenShare 停止屏幕共享
回调
startScreenShareRslt 开启屏幕共享的响应事件
stopScreenShareRslt 停止屏幕共享的响应事件
notifyScreenShareStarted 通知他人开启了屏幕共享
notifyScreenShareStopped 通知他人停止了屏幕共享
notifyScreenMarkStarted 通知屏幕标注开始
notifyScreenMarkStopped 通知屏幕标注停止

本地录制/本地直播

方式 接口 描述
主调
createLocMixer 创建本地混图器
updateLocMixerContent 更新本地混图器内容
destroyLocMixer 消毁本地混图器
getLocMixerState 获取本地混图器状态
addLocMixerOutput 开启本地录制、开启直播推流
rmLocMixerOutput 停止本地录制、直播推流
setPicResource 添加图片资源
回调
locMixerStateChanged 本地混图器状态变化通知
locMixerOutputInfo 本地录制文件、本地直播信息通知
notifyRecordFileStateChanged 通知录制文件状态更改
notifyRecordFileUploadProgress 通知录制文件上传进度

云端录制/互动直播

方式 接口 描述
主调
createCloudMixer 开始云端录制、云端直播
updateCloudMixerContent 更新云端录制、云端直播内容
destroyCloudMixer 停止云端录制、云端直播
getCloudMixerInfo 获取云端录制、云端直播信息
getAllCloudMixerInfo 获取房间内所有云端录制、云端直播信息
回调
createCloudMixerFailed 启动云端录制、云端直播失败通知
cloudMixerStateChanged 云端录制、云端直播状态变化通知
cloudMixerOutputInfoChanged 云端录制文件、云端直播输出变化通知
cloudMixerInfoChanged 云端录制、云端直播配置变化通知

接口详情

getSDKVersion

  • 功能: 获取原生SDK版本号
  • 返回值: SDK版本号
RTCSDK.getSDKVersion()

init

  • 功能: SDK初始化
  • 返回值: 无
RTCSDK.init(initObj, initCallback)
参数 类型 说明
initObj object SDK配置、临时文件存放位置,不可为空InitObj
initCallback function 回调函数,参数1为错误码

uninit

  • 功能: SDK反初始化
  • 返回值: 无
RTCSDK.uninit()

setServerAddr

  • 功能: 设置服务器地址
  • 返回值: 无
RTCSDK.setServerAddr(addr)
参数 类型 说明
addr string 服务器地址(如:www.cloudroom.com)
或多个服务器地址串(如:www.cloudroom.com:8080;183.60.47.52:8080;)

login

  • 功能: 登录
  • 返回值: 无
RTCSDK.login(LoginObj, cookie)
参数 类型 说明
LoginObj object 登录配置
cookie string 详细介绍见cookie
  • 补充说明:

登陆成功则回调 loginSuccess ,登陆失败则回调 loginFail

updateToken

  • 功能: 更新Token
  • 返回值: 无
RTCSDK.updateToken(token)
参数 类型 说明
token string Token鉴权码,详细介绍见关键词

logout

  • 功能: 注销登录
  • 返回值: 无
RTCSDK.logout()
  • 补充说明:

退出程序时,必须注销本次登录,然后再进行SDK反初始化操作

getUserAuthErrCode

  • 功能: 获取第三方鉴权失败码(只有在登录失败原因为17时有效)
  • 返回值: 第三方返回的失败码(number)
RTCSDK.getUserAuthErrCode()

getUserAuthErrDesc

  • 功能: 获取第三方鉴权失败原因描述(只有在登录失败原因为17时有效)
  • 返回值: 第三方返回的描述串(string)
RTCSDK.getUserAuthErrDesc()

setDNDStatus

  • 功能: 设置免打扰
  • 返回值: 无
RTCSDK.setDNDStatus(DNDStatus, cookie)
参数 类型 说明
DNDStatus number 0代表关闭免打扰, 其它值代表开启免打扰,含义自由定义
cookie string 详细介绍见cookie
  • 补充说明:

设置结果请参见setDNDStatusSuccess/setDNDStatusFail;
开启免打扰后,他人呼叫本人时,系统自动回绝呼叫,错误码为602;
开启免打扰后,系统将不再自动为座席分配客户autoAssignUser,座席可以调用reqAssignUser来手动分配客户(叫号模式);

getUserStatus

  • 功能: 获取本AppID下的登录用户的状态信息
  • 返回值: 无
RTCSDK.getUserStatus(userID, cookie)
参数 类型 说明
userID string 需要查询的UserID,不传或传空字符串代表获取AppId下所有用户状态信息
cookie string 详细介绍见cookie
  • 补充说明:

结果请参见getUserStatusRslt
只返回在线用户状态信息,获取不到的代表未登录

startUserStatusNotify

  • 功能: 开启AppID下的用户登录状态消息推送
  • 返回值: 无
RTCSDK.startUserStatusNotify(cookie)
参数 类型 说明
cookie string 详细介绍见cookie
  • 补充说明:

开启后他人状态变化将收到notifyUserStatus通知
开启结果请参见startStatusPushRslt
如果在线用户量很大时,将带来很大的开销请谨慎开启;

stopUserStatusNotify

  • 功能: 关闭appID下的用户在线状态消息推送
  • 返回值: 无
RTCSDK.stopUserStatusNotify(cookie)
参数 类型 说明
cookie string 详细介绍见cookie
  • 补充说明:

结果请参见stopStatusPushRslt

loginSuccess

  • 功能: 登陆成功的通知
RTCSDK.on("loginSuccess", ({ userID, cookie }) => {})
参数 类型 说明
userID string 用户ID, 详细介绍见关键词
cookie string 详细介绍见cookie

loginFail

  • 功能: 登录失败的通知
RTCSDK.on("loginFail", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

notifyTokenWillExpire

  • 功能: Token即将失效的通知
RTCSDK.on("notifyTokenWillExpire", () => {})
  • 补充说明:

采用Token模式登录,才会收到此回调;
Token到期前30秒左右回调,应尽快调用updateToken将授权更久的Token设置给SDK;

lineOff

  • 功能: 通知自己掉线
RTCSDK.on("lineOff", ({ sdkErr }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义

setDNDStatusSuccess

  • 功能: 设置免打扰成功的通知
RTCSDK.on("setDNDStatusSuccess", ({ cookie }) => {})
参数 类型 说明
cookie string 详细介绍见cookie

setDNDStatusFail

  • 功能: 设置免打扰失败的通知
RTCSDK.on("setDNDStatusFail", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

getUserStatusRslt

  • 功能: 获取用户登录状态信息的结果
RTCSDK.on("getUserStatusRslt", ({ sdkErr, userStatus, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
userStatus Array<UserStatus> 用户在线状态信息列表
cookie string 详细介绍见cookie

startStatusPushRslt

  • 功能: 开启用户状态通知结果
RTCSDK.on("startStatusPushRslt", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

stopStatusPushRslt

  • 功能: 关闭用户状态通知结果
RTCSDK.on("stopStatusPushRslt", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

notifyUserStatus

  • 功能: 通知某用户登录状态变化
RTCSDK.on("notifyUserStatus", ({ uStatus }) => {})
参数 类型 说明
uStatus UserStatus 用户在线状态信息

sendCmd

  • 功能: 发送小块数据(50K以内),此接口不能被cancelSend, 一次性发送,不会有进度通知
  • 返回值: 任务ID(string)
RTCSDK.sendCmd(targetUserId, data)
参数 类型 说明
targetUserId string 目标用户ID
data string 发送的数据(最大64KB)
  • 补充说明:

发送结果请参见sendCmdRslt
目标用户将收到通知notifyCmdData
房间内群发消息参见sendMeetingCustomMsg

sendBuffer

  • 功能: 发送点对点大数据
  • 返回值: 任务ID(string)
RTCSDK.sendBuffer(targetUserId, data)
参数 类型 说明
targetUserId string 目标用户ID
data string 发送的数据(最大100MB)
  • 补充说明:

数据将被分块发送,发送进度参见notifySendProgress
取消发送参见cancelSend
结果请参见sendBufferRslt
目标用户将收到通知notifyBufferData

sendFile

  • 功能: 发送点对点文件
  • 返回值: 任务ID(string)
RTCSDK.sendFile(targetUserId, fileName)
参数 类型 说明
targetUserId string 目标用户ID
fileName string 本地完整路径的文件名(文件内容最大100MB)
  • 补充说明:

数据将被分块发送,发送进度参见notifySendProgress
取消发送参见cancelSend
结果请参见sendFileRslt
目标用户将收到通知notifyFileData

cancelSend

  • 功能: 取消大数据、文件的发送
  • 返回值: 无
RTCSDK.cancelSend(sendId)
参数 类型 说明
sendId string 任务ID,sendBuffersendFile的返回值
  • 补充说明:

只能取消sendBuffersendFile的任务
只有任务还未发送完成的才能被取消
是否成功取消,可关注cancelSendRslt回调

sendCmdRslt

  • 功能: 发送点对点消息结果
RTCSDK.on("sendCmdRslt", ({ sendId, sdkErr }) => {})
参数 类型 说明
sendId string 任务ID,sendBuffersendFile的返回值
sdkErr number 错误码,详细见错误码定义

sendBufferRslt

  • 功能: 发送点对点大数据结果
RTCSDK.on("sendBufferRslt", ({ sendId, sdkErr }) => {})
参数 类型 说明
sendId string 任务ID,sendBuffersendFile的返回值
sdkErr number 错误码,详细见错误码定义

sendFileRslt

  • 功能: 发送点对点文件结果
RTCSDK.on("sendFileRslt", ({ sendId, fileName, sdkErr }) => {})
参数 类型 说明
sendId string 任务ID,sendBuffersendFile的返回值
fileName string 文件名
sdkErr number 错误码,详细见错误码定义

cancelSendRslt

  • 功能: 取消发送结果
RTCSDK.on("cancelSendRslt", ({ sendId, sdkErr }) => {})
参数 类型 说明
sendId string 任务ID,sendBuffersendFile的返回值
sdkErr number 错误码,详细见错误码定义

notifySendProgress

  • 功能: 通知大数据、文件的发送进度
RTCSDK.on("notifySendProgress", ({ sendId, sendedLen, totalLen }) => {})
参数 类型 说明
sendId string 任务ID,sendBuffersendFile的返回值
sendedLen number 已发送的数据长度
totalLen number 需要发送的总长度

notifyCmdData

  • 功能: 通知收到点对点透明通道消息
RTCSDK.on("notifyCmdData", ({ sourceUserId, data }) => {})
参数 类型 说明
sourceUserId string 发送者UserID
data string 数据的内容

notifyBufferData

  • 功能: 通知收到点对点大数据
RTCSDK.on("notifyBufferData", ({ sourceUserId, data }) => {})
参数 类型 说明
sourceUserId string 发送者UserID
data string 数据的内容

notifyFileData

  • 功能: 通知收到点对点文件
RTCSDK.on("notifyFileData", ({ sourceUserId, tmpFile, orgFileName }) => {})
参数 类型 说明
sourceUserId string 发送者UserID
tmpFile string 临时文件,不需要时,请移除或删除对应文件
orgFileName string 源始文件名

initQueue

  • 功能: 初始化用户队列功能数据
  • 返回值: 无
RTCSDK.initQueue(cookie)
参数 类型 说明
cookie string 详细介绍见cookie
  • 补充说明:

初始化队列结果请参见initQueueDatRslt
队列初始化成功后才可进行其它队列操作;

getAllQueueInfo

  • 功能: 获取AppID下的所有队列基础信息
  • 返回值: 队列基础信息列表(Array<QueueInfo>)
RTCSDK.getAllQueueInfo()

getQueueStatus

  • 功能: 获取指定队列的排队状况
  • 返回值: 队列状态(QueueStatus)
RTCSDK.getQueueStatus(queID)
参数 类型 说明
queID number 队列ID

getQueuingInfo

  • 功能: 获取我的排队信息
  • 返回值: 我的排队信息(QueuingInfo)
RTCSDK.getQueuingInfo()

getServiceQueues

  • 功能: 获取我服务的所有队列
  • 返回值: 队列Id列表(Array<number>)
RTCSDK.getServiceQueues()

getSessionInfo

RTCSDK.getSessionInfo()

startQueuing

  • 功能: 客户开始排队
  • 返回值: 无
RTCSDK.startQueuing(queID, usrExtDat, cookie)
参数 类型 说明
queID number 队列ID
usrExtDat string 扩展信息,分配给座席时,座席可以获取此参数
cookie string 详细介绍见cookie
  • 补充说明:

客户同一时间,只能排一个队列;
排队结果请参见startQueuingRslt

stopQueuing

  • 功能: 客户停止排队
  • 返回值: 无
RTCSDK.stopQueuing(cookie)
参数 类型 说明
cookie string 详细介绍见cookie
  • 补充说明:

排队结果请参见stopQueuingRslt

startService

  • 功能: 座席开始服务某队列
  • 返回值: 无
RTCSDK.startService(queID, priority, cookie)
参数 类型 说明
queID number 队列ID
priority number 坐席优先级 (缺省为0,取值为0~1000内整数。值越小优先级越高。0为最高优先级)
cookie string 详细介绍见cookie
  • 补充说明:

可以多次调用,开启对多个队列的服务;
开启服务结果请参见startServiceRslt
开启成功后:
a. 如果没有开启免打扰setDNDStatus,那么系统会自动分配客户:autoAssignUser
b. 如果开启免打挽,系统就不会分配客户,如需服务客户可调用:reqAssignUser
座席优先级描述:
a. 客户优先分配给服务此队列优先级最高的,且空闲的座席;
b. 优先级相同时,则分配给最先空闲的座席;
c. 优先级高的座席变空闲时,不抢夺已分配的客户;

stopService

  • 功能: 座席停止服务某队列
  • 返回值: 无
RTCSDK.stopService(queID, cookie)
参数 类型 说明
queID number 队列ID
cookie string 详细介绍见cookie
  • 补充说明:

停止服务结果请参见stopServiceRslt

reqAssignUser

  • 功能: 座席手动分配客户
  • 返回值: 无
RTCSDK.reqAssignUser(cookie)
参数 类型 说明
cookie string 详细介绍见cookie
  • 补充说明:

开启免打扰后手动分配客户接口;(当关闭免打扰时,系统将自动分配客户,无需调用此接口)
分配结果请参见reqAssignUserRslt

acceptAssignUser

  • 功能: 接受系统自动分配的客户
  • 返回值: 无
RTCSDK.acceptAssignUser(queID, userID, cookie)
参数 类型 说明
queID number 队列ID
userID string 用户ID, 详细介绍见关键词
cookie string 详细介绍见cookie
  • 补充说明:

结果请参见responseAssignUserRslt

rejectAssignUser

  • 功能: 拒绝系统自动分配的客户
  • 返回值: 无
RTCSDK.rejectAssignUser(queID, userID, cookie)
参数 类型 说明
queID number 队列ID
userID string 用户ID, 详细介绍见关键词
cookie string 详细介绍见cookie
  • 补充说明:

结果请参见responseAssignUserRslt

initQueueDatRslt

  • 功能: 初始化队列功能结果
RTCSDK.on("initQueueDatRslt", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

queueStatusChanged

  • 功能: 队列排队状态更新
RTCSDK.on("queueStatusChanged", ({ queStatus }) => {})
参数 类型 说明
queStatus QueueStatus 队列排队状态信息

queuingInfoChanged

  • 功能: 我的排队信息更新
RTCSDK.on("queuingInfoChanged", ({ queuingInfo }) => {})
参数 类型 说明
queuingInfo QueuingInfo 我的排队信息

startQueuingRslt

  • 功能: 客户开始排队结果
RTCSDK.on("startQueuingRslt", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

stopQueuingRslt

  • 功能: 客户停止排队结果
RTCSDK.on("stopQueuingRslt", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

startServiceRslt

  • 功能: 座席开始服务结果
RTCSDK.on("startServiceRslt", ({ queID, sdkErr, cookie }) => {})
参数 类型 说明
queID number 队列ID
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

stopServiceRslt

  • 功能: 座席停止服务结果
RTCSDK.on("stopServiceRslt", ({ queID, sdkErr, cookie }) => {})
参数 类型 说明
queID number 队列ID
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

responseAssignUserRslt

  • 功能: 响应分配客户操作结果
RTCSDK.on("responseAssignUserRslt", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

autoAssignUser

  • 功能: 座席自动分配客户通知
RTCSDK.on("autoAssignUser", ({ usr }) => {})
参数 类型 说明
usr UserInfo 客户信息
  • 补充说明:

如果不需要系统的自动分配,请通setDNDStatus开启免打扰功能;
acceptAssignUser后,还需要调用call去呼叫对方进入目标房间;
收到系统分配的客户后,如果座席不acceptAssignUser也不rejectAssignUser,系统将在30秒后取消本次分配cancelAssignUser,然后将客户放回到队首

reqAssignUserRslt

  • 功能: 座席手动分配客户结果
RTCSDK.on("reqAssignUserRslt", ({ sdkErr, usr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
usr UserInfo 客户信息
cookie string 详细介绍见cookie

cancelAssignUser

  • 功能: 通知分配的客户取消了
RTCSDK.on("cancelAssignUser", ({ queID, userID }) => {})
参数 类型 说明
queID number 队列ID
userID string 用户ID, 详细介绍见关键词
  • 补充说明:

被取消的原因,可能是用户取消排队了,或者用户掉线了,或者收到autoAssignUser后没有及时acceptAssignUser / rejectAssignUser

call

  • 功能: 发起呼叫
  • 返回值: 呼叫ID(string)
RTCSDK.call(calledUserID, ID, usrExtDat, cookie)
参数 类型 说明
calledUserID string 被叫用户ID
ID number 房间号
usrExtDat string 扩展信息
cookie string 详细介绍见cookie
  • 补充说明:

发起的呼叫结果参见callRslt
呼叫时,对方迟迟不acceptCall / rejectCall,30秒后将超时而自动结束呼叫;
如果呼叫SIP/H.323设备, usrExtDat可以指定为:
{"devInfo":{"autoOpenMic":0}};
其中 devInfo 可参考 CRDevJoinCfg

acceptCall

  • 功能: 接受他人的呼叫
  • 返回值: 无
RTCSDK.acceptCall(callID, ID, usrExtDat, cookie)
参数 类型 说明
callID string 呼叫ID, 参见call / callMoreParty返回值
ID number 房间号
usrExtDat string 扩展信息
cookie string 详细介绍见cookie
  • 补充说明:

接受结果参见acceptCallRslt

rejectCall

  • 功能: 拒接他人的呼叫
  • 返回值: 无
RTCSDK.rejectCall(callID, usrExtDat, cookie)
参数 类型 说明
callID string 呼叫ID, 参见call / callMoreParty返回值
usrExtDat string 扩展信息
cookie string 详细介绍见cookie
  • 补充说明:

接受结果参见rejectCallRslt

hangupCall

  • 功能: 挂断通话
  • 返回值: 无
RTCSDK.hangupCall(callID, usrExtDat, cookie)
参数 类型 说明
callID string 呼叫ID, 参见call / callMoreParty返回值
usrExtDat string 扩展信息
cookie string 详细介绍见cookie
  • 补充说明:

挂断结果参见hangupCallRslt

callMoreParty

  • 功能: 发起多方呼叫(或呼转)
  • 返回值: 呼叫ID(string)
RTCSDK.callMoreParty(calledUserID, ID, usrExtDat, cookie)
参数 类型 说明
calledUserID string 被叫用户ID
ID number 房间号
usrExtDat string 扩展信息
cookie string 详细介绍见cookie
  • 补充说明:

呼叫结果参见callMorePartyRslt
呼转实现思路: A、B通话已建立(假设callID为IdAB),B想由C来服务A,B callMoreParty C(假设callID为IdBC), 在C接受进入通话后,A便可挂断IdAB通话并离开房间。

cancelCallMoreParty

  • 功能: 取消多方呼叫
  • 返回值: 无
RTCSDK.cancelCallMoreParty(callID, usrExtDat, cookie)
参数 类型 说明
callID string 呼叫ID, 参见call / callMoreParty返回值
usrExtDat string 扩展信息
cookie string 详细介绍见cookie
  • 补充说明:

取消结果参见cancelCallMorePartyRslt

callRslt

  • 功能: 发起的呼叫结果
RTCSDK.on("callRslt", ({ callID, sdkErr, cookie }) => {})
参数 类型 说明
callID string 呼叫ID, 参见call / callMoreParty返回值
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

acceptCallRslt

  • 功能: 接受他人呼叫的结果
RTCSDK.on("acceptCallRslt", ({ callID, sdkErr, cookie }) => {})
参数 类型 说明
callID string 呼叫ID, 参见call / callMoreParty返回值
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

rejectCallRslt

  • 功能: 拒绝他人呼叫的结果
RTCSDK.on("rejectCallRslt", ({ callID, sdkErr, cookie }) => {})
参数 类型 说明
callID string 呼叫ID, 参见call / callMoreParty返回值
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

hangupCallRslt

  • 功能: 挂断通话结果
RTCSDK.on("hangupCallRslt", ({ callID, sdkErr, cookie }) => {})
参数 类型 说明
callID string 呼叫ID, 参见call / callMoreParty返回值
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

notifyCallIn

  • 功能: 通知呼入
RTCSDK.on("notifyCallIn", ({ callID, ID, callerID, usrExtDat }) => {})
参数 类型 说明
callID string 呼叫ID, 参见call / callMoreParty返回值
ID number 房间号
callerID string 主叫用户ID
usrExtDat string 扩展信息

notifyCallAccepted

  • 功能: 通知呼叫被接受
RTCSDK.on("notifyCallAccepted", ({ callID, ID, usrExtDat }) => {})
参数 类型 说明
callID string 呼叫ID, 参见call / callMoreParty返回值
ID number 房间号
usrExtDat string 扩展信息

notifyCallRejected

  • 功能: 通知呼叫被拒接
RTCSDK.on("notifyCallRejected", ({ callID, sdkErr, usrExtDat }) => {})
参数 类型 说明
callID string 呼叫ID, 参见call / callMoreParty返回值
sdkErr number 错误码,详细见错误码定义
usrExtDat string 扩展信息

notifyCallHungup

  • 功能: 通知呼叫被挂断
RTCSDK.on("notifyCallHungup", ({ callID, usrExtDat }) => {})
参数 类型 说明
callID string 呼叫ID, 参见call / callMoreParty返回值
usrExtDat string 扩展信息

callMorePartyRslt

  • 功能: 发起多方呼叫结果
RTCSDK.on("callMorePartyRslt", ({ callID, sdkErr, cookie }) => {})
参数 类型 说明
callID string 呼叫ID, 参见call / callMoreParty返回值
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

cancelCallMorePartyRslt

  • 功能: 取消多方呼叫结果
RTCSDK.on("cancelCallMorePartyRslt", ({ callID, sdkErr, cookie }) => {})
参数 类型 说明
callID string 呼叫ID, 参见call / callMoreParty返回值
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

notifyCallMorePartyStatus

  • 功能: 通知多方呼叫状态
RTCSDK.on("notifyCallMorePartyStatus", ({ callID, sdkErr, status }) => {})
参数 类型 说明
callID string 呼叫ID, 参见call / callMoreParty返回值
sdkErr number 错误码,详细见错误码定义
status number 多方呼叫状态,值参见INVITE_STATUS

invite

  • 功能: 发送邀请
  • 返回值: 邀请ID(string)
RTCSDK.invite(invitedUserID, usrExtDat, cookie)
参数 类型 说明
invitedUserID string 邀请的用户ID
usrExtDat string 扩展信息
cookie string 详细介绍见cookie
  • 补充说明:

邀请结果参见inviteRslt

acceptInvite

  • 功能: 接受邀请
  • 返回值: 无
RTCSDK.acceptInvite(inviteID, usrExtDat, cookie)
参数 类型 说明
inviteID string 邀请ID,参见invite返回值
usrExtDat string 扩展信息
cookie string 详细介绍见cookie
  • 补充说明:

接受结果参见acceptInviteRslt

rejectInvite

  • 功能: 拒接邀请
  • 返回值: 无
RTCSDK.rejectInvite(inviteID, usrExtDat, cookie)
参数 类型 说明
inviteID string 邀请ID,参见invite返回值
usrExtDat string 扩展信息
cookie string 详细介绍见cookie
  • 补充说明:

拒接结果参见rejectInviteRslt

cancelInvite

  • 功能: 取消邀请
  • 返回值: 无
RTCSDK.cancelInvite(inviteID, usrExtDat, cookie)
参数 类型 说明
inviteID string 邀请ID,参见invite返回值
usrExtDat string 扩展信息
cookie string 详细介绍见cookie
  • 补充说明:

取消结果参见cancelInviteRslt

inviteRslt

  • 功能: 邀请他人结果
RTCSDK.on("inviteRslt", ({ inviteID, sdkErr, cookie }) => {})
参数 类型 说明
inviteID string 邀请ID,参见invite返回值
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

acceptInviteRslt

  • 功能: 接受邀请结果
RTCSDK.on("acceptInviteRslt", ({ inviteID, sdkErr, cookie }) => {})
参数 类型 说明
inviteID string 邀请ID,参见invite返回值
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

rejectInviteRslt

  • 功能: 拒接邀请结果
RTCSDK.on("rejectInviteRslt", ({ inviteID, sdkErr, cookie }) => {})
参数 类型 说明
inviteID string 邀请ID,参见invite返回值
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

cancelInviteRslt

  • 功能: 取消邀请结果
RTCSDK.on("cancelInviteRslt", ({ inviteID, sdkErr, cookie }) => {})
参数 类型 说明
inviteID string 邀请ID,参见invite返回值
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

notifyInviteIn

  • 功能: 通知收到邀请
RTCSDK.on("notifyInviteIn", ({ inviteID, inviterUsrID, usrExtDat }) => {})
参数 类型 说明
inviteID string 邀请ID,参见invite返回值
inviterUsrID string 邀请人ID
usrExtDat string 扩展信息

notifyInviteAccepted

  • 功能: 通知邀请被接受
RTCSDK.on("notifyInviteAccepted", ({ inviteID, usrExtDat }) => {})
参数 类型 说明
inviteID string 邀请ID,参见invite返回值
usrExtDat string 扩展信息

notifyInviteRejected

  • 功能: 通知邀请被拒接
RTCSDK.on("notifyInviteRejected", ({ inviteID, sdkErr, usrExtDat }) => {})
参数 类型 说明
inviteID string 邀请ID,参见invite返回值
sdkErr number 错误码,详细见错误码定义
usrExtDat string 扩展信息

notifyInviteCanceled

  • 功能: 通知邀请被取消
RTCSDK.on("notifyInviteCanceled", ({ inviteID, sdkErr, usrExtDat }) => {})
参数 类型 说明
inviteID string 邀请ID,参见invite返回值
sdkErr number 错误码,详细见错误码定义
usrExtDat string 扩展信息

createMeeting

  • 功能: 创建房间
  • 返回值: 无
RTCSDK.createMeeting(cookie)
参数 类型 说明
cookie string 详细介绍见cookie
  • 补充说明:

操作成功则回调createMeetingSuccess,失败则回调createMeetingFail

destroyMeeting

  • 功能: 销毁房间
  • 返回值: 无
RTCSDK.destroyMeeting(ID, cookie)
参数 类型 说明
ID number 房间号
cookie string 详细介绍见cookie
  • 补充说明:

回调函数destroyMeetingRslt

createMeetingSuccess

  • 功能: 通知创建房间成功
RTCSDK.on("createMeetingSuccess", ({ ID, cookie }) => {})
参数 类型 说明
ID number 房间号
cookie string 详细介绍见cookie

createMeetingFail

  • 功能: 通知创建房间失败
RTCSDK.on("createMeetingFail", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

destroyMeetingRslt

  • 功能: 销毁房间响应
RTCSDK.on("destroyMeetingRslt", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

enterMeeting

  • 功能: 进入房间
  • 返回值: 无
RTCSDK.enterMeeting(ID)
参数 类型 说明
ID number 房间号
  • 补充说明:

操作完成则回调enterMeetingRslt

exitMeeting

  • 功能: 离开房间
  • 返回值: 无
RTCSDK.exitMeeting()

kickout

  • 功能: 将房间内指定成员踢出房间
  • 返回值: 无
RTCSDK.kickout(userID)
参数 类型 说明
userID string 用户ID, 详细介绍见关键词

enterMeetingRslt

  • 功能: 进入房间结果
RTCSDK.on("enterMeetingRslt", ({ sdkErr }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义

userEnterMeeting

  • 功能: 有人进入房间通知
RTCSDK.on("userEnterMeeting", ({ userID }) => {})
参数 类型 说明
userID string 用户ID, 详细介绍见关键词

userLeftMeeting

  • 功能: 有人离开房间通知
RTCSDK.on("userLeftMeeting", ({ userID }) => {})
参数 类型 说明
userID string 用户ID, 详细介绍见关键词

kickoutRslt

  • 功能: 踢人的结果通知
RTCSDK.on("kickoutRslt", ({ sdkErr, userID }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
userID string 用户ID, 详细介绍见关键词

meetingDropped

  • 功能: 通知从房间里掉线了,收到该通知后可以调用enterMeeting尝试重新进入房间
RTCSDK.on("meetingDropped", ({ reason }) => {})
参数 类型 说明
reason number 掉线原因,值参见MEETING_DROPPED_REASON

meetingStopped

  • 功能: 通知房间已被结束
RTCSDK.on("meetingStopped", () => {})

getAllMembers

  • 功能: 获取房间所有成员信息列表
  • 返回值: 返回含多个成员信息(Array ------MemberInfo
RTCSDK.getAllMembers()

getMemberInfo

  • 功能: 获取单个成员信息
  • 返回值: 返回成员信息(MemberInfo
RTCSDK.getMemberInfo(userID)
参数 类型 说明
userID string 用户ID, 详细介绍见关键词

sendMeetingCustomMsg

  • 功能: 房间内发送广播消息
  • 返回值: 无
RTCSDK.sendMeetingCustomMsg(msg, cookie)
参数 类型 说明
msg string 发送的文本
cookie string 详细介绍见cookie
  • 补充说明:

需要进进入房间议后才能调用

notifyNickNameChanged

  • 功能: SDK通知某用户改变了昵称
RTCSDK.on("notifyNickNameChanged", ({ userID, oldName, newName }) => {})
参数 类型 说明
userID string 用户ID, 详细介绍见关键词
oldName string 改变之前的昵称
newName string 改变之后的昵称
  • 补充说明:

改昵称的用户自身不会接收到此通知

sendMeetingCustomMsgRslt

  • 功能: 通知发送房间内自定义广播消息结果
RTCSDK.on("sendMeetingCustomMsgRslt", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

notifyMeetingCustomMsg

  • 功能: 通知接收到房间内用户自定义广播
RTCSDK.on("notifyMeetingCustomMsg", ({ fromUserID, text }) => {})
参数 类型 说明
fromUserID string 房间内广播消息的发送者的用户id
text string 广播内容

netStateChanged

  • 功能: 通知我的网络变化
RTCSDK.on("netStateChanged", ({ level }) => {})
参数 类型 说明
level number 网络状况等级(0~10,10分为最佳网络)

getMeetingAllAttrs

  • 功能: 获取所有房间属性
  • 返回值: 无
RTCSDK.getMeetingAllAttrs(cookie)
参数 类型 说明
cookie string 详细介绍见cookie
  • 补充说明:

获取结果请参见:getMeetingAllAttrsSuccessgetMeetingAllAttrsFail

getMeetingAttrs

  • 功能: 获取部份房间属性
  • 返回值: 无
RTCSDK.getMeetingAttrs(keys, cookie)
参数 类型 说明
keys Array<string> 需要查询的房间属性key,如:["key1", "key2"]
cookie string 详细介绍见cookie
  • 补充说明:

获取结果请参见:getMeetingAttrsSuccessgetMeetingAttrsFail

setMeetingAttrs

  • 功能: 重置所有房间属性
  • 返回值: 无
RTCSDK.setMeetingAttrs(attrs, options, cookie)
参数 类型 说明
attrs object 房间属性集,如:{"key1":"value1", "key2":"value2"} (key最大长度为64B,value最大长度为8KB)
options object 操作选项,参见CRAttrOptions
cookie string 详细介绍见cookie
  • 补充说明:

设置结果请参见:setMeetingAttrsRslt

addOrUpdateMeetingAttrs

  • 功能: 添加或更新房间属性
  • 返回值: 无
RTCSDK.addOrUpdateMeetingAttrs(attrs, options, cookie)
参数 类型 说明
attrs object 房间属性集,如:{"key1":"value1", "key2":"value2"} (key最大长度为64B,value最大长度为8KB)
options object 操作选项,参见CRAttrOptions
cookie string 详细介绍见cookie
  • 补充说明:

结果请参见:addOrUpdateMeetingAttrsRslt

delMeetingAttrs

  • 功能: 删除房间属性
  • 返回值: 无
RTCSDK.delMeetingAttrs(keys, options, cookie)
参数 类型 说明
keys Array<string> 需要删除的房间属性key,如:["key1", "key2"]
options object 操作选项,参见CRAttrOptions
cookie string 详细介绍见cookie
  • 补充说明:

结果请参见:delMeetingAttrsRslt

clearMeetingAttrs

  • 功能: 清空所有房间属性
  • 返回值: 无
RTCSDK.clearMeetingAttrs(options, cookie)
参数 类型 说明
options object 操作选项,参见CRAttrOptions
cookie string 详细介绍见cookie
  • 补充说明:

结果请参见:clearMeetingAttrsRslt

getMeetingAllAttrsSuccess

  • 功能: 获取所有房间属性成功
RTCSDK.on("getMeetingAllAttrsSuccess", ({ attrSeq, cookie }) => {})
参数 类型 说明
attrSeq object 房间属性集,结构体请参见CRAttrObjs
cookie string 详细介绍见cookie

getMeetingAllAttrsFail

  • 功能: 获取所有房间属性失败
RTCSDK.on("getMeetingAllAttrsFail", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

getMeetingAttrsSuccess

  • 功能: 获取部份房间属性成功
RTCSDK.on("getMeetingAttrsSuccess", ({ attrSeq, cookie }) => {})
参数 类型 说明
attrSeq object 房间属性集,结构体请参见CRAttrObjs
cookie string 详细介绍见cookie

getMeetingAttrsFail

  • 功能: 获取部份房间属性失败
RTCSDK.on("getMeetingAttrsFail", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

setMeetingAttrsRslt

  • 功能: 重置所有房间属性结果
RTCSDK.on("setMeetingAttrsRslt", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

addOrUpdateMeetingAttrsRslt

  • 功能: 添加或更新房间属性结果
RTCSDK.on("addOrUpdateMeetingAttrsRslt", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

delMeetingAttrsRslt

  • 功能: 删除房间属性结果
RTCSDK.on("delMeetingAttrsRslt", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

clearMeetingAttrsRslt

  • 功能: 清空所有房间属性结果
RTCSDK.on("clearMeetingAttrsRslt", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

notifyMeetingAttrsChanged

  • 功能: 通知房间属性改变
RTCSDK.on("notifyMeetingAttrsChanged", ({ add, updates, delKeys }) => {})
参数 类型 说明
add object 增加房间属性集,结构体请参见CRAttrObjs
updates object 变化的用户属性集,结构体请参见CRAttrObjs
delKeys Array<string> 被删除的用户属性列表,如:["key1", "key2"]

getUserAttrs

  • 功能: 获取指定用户的属性
  • 返回值: 无
RTCSDK.getUserAttrs(userIDs, keys, cookie)
参数 类型 说明
userIDs Array<string> 目标用户id列表,一次最多包含50个用户, 如:["uid1","uid2"]
keys Array<string> 将要获取的用户属性key列表(空串代表获取全部),如:["key1","key2"]
cookie string 详细介绍见cookie
  • 补充说明:

结果请参见:getUserAttrsSuccessgetUserAttrsFail

setUserAttrs

  • 功能: 重置指定用户的属性
  • 返回值: 无
RTCSDK.setUserAttrs(userID, attrs, options, cookie)
参数 类型 说明
userID string 用户ID, 详细介绍见关键词
attrs object 用户属性集, 如:{"key1":"value1", "key2":"value2"} (key最大长度为64B,value最大长度为8KB)
options object 操作选项,参见CRAttrOptions
cookie string 详细介绍见cookie
  • 补充说明:

结果请参见:setUserAttrsRslt

addOrUpdateUserAttrs

  • 功能: 添加或更新指定用户的属性
  • 返回值: 无
RTCSDK.addOrUpdateUserAttrs(userID, attrs, options, cookie)
参数 类型 说明
userID string 用户ID, 详细介绍见关键词
attrs object 用户属性集, 如:{"key1":"value1", "key2":"value2"} (key最大长度为64B,value最大长度为8KB)
options object 操作选项,参见CRAttrOptions
cookie string 详细介绍见cookie
  • 补充说明:

结果请参见:addOrUpdateUserAttrsRslt

delUserAttrs

  • 功能: 删除指定用户的属性
  • 返回值: 无
RTCSDK.delUserAttrs(userID, keys, options, cookie)
参数 类型 说明
userID string 用户ID, 详细介绍见关键词
keys Array<string> 需要删除的用户属性key列表,如:["key1","key2"]
options object 操作选项,参见CRAttrOptions
cookie string 详细介绍见cookie
  • 补充说明:

结果请参见:delUserAttrsRslt

clearUserAttrs

  • 功能: 清空指定用户的属性
  • 返回值: 无
RTCSDK.clearUserAttrs(userID, options, cookie)
参数 类型 说明
userID string 用户ID, 详细介绍见关键词
options object 操作选项,参见CRAttrOptions
cookie string 详细介绍见cookie
  • 补充说明:

结果请参见:clearUserAttrsRslt

clearAllUserAttrs

  • 功能: 清空所有用户的属性
  • 返回值: 无
RTCSDK.clearAllUserAttrs(options, cookie)
参数 类型 说明
options object 操作选项,参见CRAttrOptions
cookie string 详细介绍见cookie
  • 补充说明:

结果请参见:clearAllUserAttrsRslt

getUserAttrsSuccess

  • 功能: 获取指定用户的所有属性成功
RTCSDK.on("getUserAttrsSuccess", ({ attrMap, cookie }) => {})
参数 类型 说明
attrMap object 用户属性集,结构体请参见CRUsrAttrObjs
cookie string 详细介绍见cookie

getUserAttrsFail

  • 功能: 获取指定用户的所有属性失败
RTCSDK.on("getUserAttrsFail", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

setUserAttrsRslt

  • 功能: 重置指定用户的属性结果
RTCSDK.on("setUserAttrsRslt", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

addOrUpdateUserAttrsRslt

  • 功能: 添加或更新指定用户的属性结果
RTCSDK.on("addOrUpdateUserAttrsRslt", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

delUserAttrsRslt

  • 功能: 删除指定用户的属性结果
RTCSDK.on("delUserAttrsRslt", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

clearUserAttrsRslt

  • 功能: 清空指定用户的属性结果
RTCSDK.on("clearUserAttrsRslt", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

clearAllUserAttrsRslt

  • 功能: 清空所有用户的属性结果
RTCSDK.on("clearAllUserAttrsRslt", ({ sdkErr, cookie }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义
cookie string 详细介绍见cookie

notifyUserAttrsChanged

  • 功能: 通知用户属性改变
RTCSDK.on("notifyUserAttrsChanged", ({ userID, add, updates, delKeys }) => {})
参数 类型 说明
userID string 用户ID, 详细介绍见关键词
add object 增加的用户属性集,结构体请参见CRUsrAttrObjs
updates object 变化的用户属性集,结构体请参见CRUsrAttrObjs
delKeys Array<string> 被删除的用户属性列表,格式如:["key1", "key2"]

openMic

  • 功能: 打开麦克风
  • 返回值: 无
RTCSDK.openMic(userID)
参数 类型 说明
userID string 用户ID, 详细介绍见关键词
  • 补充说明:

打开自已的麦克风时,先会进入到AOPENING状态,等服务器处理后才会进入AOPEN状态,此时说话才能被采集到。回调函数audioStatusChanged

closeMic

  • 功能: 关闭麦克风
  • 返回值: 无
RTCSDK.closeMic(userID)
参数 类型 说明
userID string 用户ID, 详细介绍见关键词
  • 补充说明:

关麦操作是立即生效的,本地会立即停止采集。回调函数audioStatusChanged

setAllAudioClose

  • 功能: 关闭所有人的麦克风
  • 返回值: 无
RTCSDK.setAllAudioClose()
  • 补充说明:

关闭所有用户的麦克风(自己除外) , 调用此接口后会话内其他人的麦克风会关闭,同时收到消息audioStatusChanged

getAudioCfg

  • 功能: 获取音频参数
  • 返回值: 音频配置,参见AudioCfg
RTCSDK.getAudioCfg()

setAudioCfg

  • 功能: 设置音频参数
  • 返回值: 无
RTCSDK.setAudioCfg(AudioCfg)
参数 类型 说明
AudioCfg object 音频配置,参见AudioCfg
  • 补充说明:

注意:成功进入房间后,才可以设置音频属性。

getSpeakerVolume

  • 功能: 获取本地扬声器音量
  • 返回值: 本地扬声器音量(number),音量等级类型 0-255
RTCSDK.getSpeakerVolume()

setSpeakerVolume

  • 功能: 设置本地扬声器音量
  • 返回值: 无
RTCSDK.setSpeakerVolume(level)
参数 类型 说明
level number 本地扬声器音量,取值:0-255

getSpeakerOut

  • 功能: 获取当前是否外放
  • 返回值: Boolean
RTCSDK.getSpeakerOut()

setSpeakerOut

  • 功能: 设置是否外放
  • 返回值: 无
RTCSDK.setSpeakerOut(speakerOut)
参数 类型 说明
speakerOut boolean 是否外放

startGetAudioPCM

  • 功能: 开始获取语音pcm数据
  • 返回值: 无
RTCSDK.startGetAudioPCM(aSide, getType, jsonParam)
参数 类型 说明
aSide number 声道类型 0:麦克风,1:扬声器
getType number 获取方式 0:回调方式,1:保存为文件
jsonParam string 当getType=0 表示回调方式,jsonParam可配置回调的数据大小(320-32000),如: {"EachSize":320};
当getType=1 表示保存为文件,jsonParam可配置文件名,如: { "FileName" : "/sdcard/test.pcm" }

stopGetAudioPCM

  • 功能: 停止获取语音pcm数据
  • 返回值: 无
RTCSDK.stopGetAudioPCM(aSide)
参数 类型 说明
aSide number 声道类型 0:麦克风,1:扬声器

audioStatusChanged

  • 功能: 通知用户音频状态变化
RTCSDK.on("audioStatusChanged", ({ userID, oldStatus, newStatus }) => {})
参数 类型 说明
userID string 用户ID, 详细介绍见关键词
oldStatus number 旧状态,参考麦克风状态
newStatus number 新状态,参考麦克风状态

micEnergyUpdate

  • 功能: 通知成员麦克风声音能量变化
RTCSDK.on("micEnergyUpdate", ({ userID, oldLevel, newLevel }) => {})
参数 类型 说明
userID string 用户ID, 详细介绍见关键词
oldLevel number 原来的说话声音强度等级,0-10
newLevel number 现在的说话声音强度等级,0-10

notifyAudioPCMData

  • 功能: 通知语音PCM数据
RTCSDK.on("notifyAudioPCMData", ({ aSide, audioDat }) => {})
参数 类型 说明
aSide number 声道类型 0:麦克风,1:扬声器
audioDat array PCM数据

openVideo

  • 功能: 打开摄像头
  • 返回值: 无
RTCSDK.openVideo(userID)
参数 类型 说明
userID string 用户ID, 详细介绍见关键词

closeVideo

  • 功能: 关闭摄像头
  • 返回值: 无
RTCSDK.closeVideo(userID)
参数 类型 说明
userID string 用户ID, 详细介绍见关键词

getMyVideoPosition

RTCSDK.getMyVideoPosition()

getVideoCfg

  • 功能: 获取设置的摄像头参数
  • 返回值: 摄像头参数,参见VideoCfg
RTCSDK.getVideoCfg()

setVideoCfg

  • 功能: 设置摄像头参数
  • 返回值: 无
RTCSDK.setVideoCfg(VideoCfg)
参数 类型 说明
VideoCfg object 摄像头参数,参见VideoCfg

getVideoEffects

  • 功能: 获取视频效果配置
  • 返回值: 视频效果配置,参见VideoEffects
RTCSDK.getVideoEffects()
  • 补充说明:

该接口仅安卓可用

setVideoEffects

  • 功能: 设置视频效果配置
  • 返回值: 无
RTCSDK.setVideoEffects(VideoEffects)
参数 类型 说明
VideoEffects object 视频效果配置,参见VideoEffects
  • 补充说明:

该接口仅安卓可用

getDefaultVideo

  • 功能: 获取指定用户的默认摄像头
  • 返回值: 摄像头ID
RTCSDK.getDefaultVideo(userID)
参数 类型 说明
userID string 用户ID, 详细介绍见关键词

setDefaultVideo

  • 功能: 设置默认的摄像头
  • 返回值: 无
RTCSDK.setDefaultVideo(userID, videoID)
参数 类型 说明
userID string 用户ID, 详细介绍见关键词
videoID number 摄像头ID, 自己的摄像头可通过getMyVideoPosition获取

getLocVideoAttributes

  • 功能: 获取某个摄像头私有属性
  • 返回值: VideoAttributes,摄像头私有属性
RTCSDK.getLocVideoAttributes(videoID)
参数 类型 说明
videoID number 本地摄像头ID

setLocVideoAttributes

  • 功能: 设置某个摄像头私有属性
  • 返回值: 无
RTCSDK.setLocVideoAttributes(videoID, attributes)
参数 类型 说明
videoID number 本地摄像头ID
attributes VideoAttributes 摄像头私有属性

getWatchableVideos

  • 功能: 获取房间内所有可观看的摄像头
  • 返回值: 房间内所有可观看的摄像头列表,数据类型为: <UsrVideoId>[]
RTCSDK.getWatchableVideos()

getAllVideoInfo

  • 功能: 获取用户的所有摄像头信息(包含未开启的摄像头)
  • 返回值: 用户的所有摄像头信息列表,数据类型为: VideoInfosObj
RTCSDK.getAllVideoInfo(userID)
参数 类型 说明
userID string 用户ID, 详细介绍见关键词

videoStatusChanged

  • 功能: 通知用户视频状态变化
RTCSDK.on("videoStatusChanged", ({ userID, oldStatus, newStatus }) => {})
参数 类型 说明
userID string 用户ID, 详细介绍见关键词
oldStatus number 旧状态,参考摄像头状态
newStatus number 新状态,参考摄像头状态

openVideoRslt

  • 功能: 打开摄像头设备操作结果
RTCSDK.on("openVideoRslt", ({ deviceID, success }) => {})
参数 类型 说明
deviceID string 摄像头设备ID
success boolean 是否成功

videoDevChanged

  • 功能: 通知用户的视频设备有变化
RTCSDK.on("videoDevChanged", ({ userID }) => {})
参数 类型 说明
userID string 用户ID, 详细介绍见关键词

getMediaCfg

  • 功能: 获取影音共享配置参数
  • 返回值: 影音共享配置参数,参见VideoCfg
RTCSDK.getMediaCfg()

setMediaCfg

  • 功能: 配置影音共享图像质量参数
  • 返回值: 无
RTCSDK.setMediaCfg(VideoCfg)
参数 类型 说明
VideoCfg object 影音共享配置参数,参见VideoCfg

startPlayMedia

  • 功能: 播放影音文件
  • 返回值: 无
RTCSDK.startPlayMedia(filename, bLocPlay)
参数 类型 说明
filename string 文件名,全路径
bLocPlay number 播放模式:0:房间内播放(默认值) 1:本地播放

pausePlayMedia

  • 功能: 暂停或恢复播放影音
  • 返回值: 无
RTCSDK.pausePlayMedia(isPause)
参数 类型 说明
isPause boolean 是否暂停

stopPlayMedia

  • 功能: 停止影音播放
  • 返回值: 无
RTCSDK.stopPlayMedia()
  • 补充说明:

回调函数notifyMediaStop

setMediaPlayPos

  • 功能: 设置播放进度
  • 返回值: 无
RTCSDK.setMediaPlayPos(pos)
参数 类型 说明
pos number 设置播放位置,单位:毫秒

getMediaInfo

  • 功能: 查询当前影音共享状态
  • 返回值: 影音文件信息MediaInfoObj
RTCSDK.getMediaInfo()

notifyMediaOpened

  • 功能: 通知影音文件打开
RTCSDK.on("notifyMediaOpened", ({ totalTime, width, height }) => {})
参数 类型 说明
totalTime number 影音时长(毫秒)
width number 视频宽
height number 视频高
  • 补充说明:

收到该通知即可渲染媒体共享组件

notifyMediaStart

  • 功能: 收到他人开启了影音共享的通知
RTCSDK.on("notifyMediaStart", ({ userID }) => {})
参数 类型 说明
userID string 开启影音共享用户的userID
  • 补充说明:

收到该通知即可渲染媒体共享组件

notifyMediaPause

  • 功能: 收到他人暂停了影音共享的通知
RTCSDK.on("notifyMediaPause", ({ userID, pause }) => {})
参数 类型 说明
userID string 开启屏幕共享用户的userID
pause boolean 是否暂停状态

notifyMediaStop

  • 功能: 收到他人停止了影音共享的通知
RTCSDK.on("notifyMediaStop", ({ userID, reason }) => {})
参数 类型 说明
userID string 开启屏幕共享用户的userID
reason number 播放停止原因,数值参考reason
  • 补充说明:

收到该通知即可销毁媒体共享组件

getScreenShareCfg

  • 功能: 获取屏幕共享配置
  • 返回值: 屏幕共享配置,参见ScreenShareCfg
RTCSDK.getScreenShareCfg()

setScreenShareCfg

  • 功能: 设置本地屏幕共享配置
  • 返回值: 无
RTCSDK.setScreenShareCfg(ScreenShareCfg)
参数 类型 说明
ScreenShareCfg object 屏幕共享配置,参见ScreenShareCfg

startScreenShare

  • 功能: 开启屏幕共享
  • 返回值: 无
RTCSDK.startScreenShare(ScreenMessageCfg)
参数 类型 说明
ScreenMessageCfg object 系统通知的配置,仅安卓平台有效,iOS可不传,内容参见ScreenMessageCfg
  • 补充说明:

回调函数startScreenShareRslt
屏幕共享需要相应授权,否则无法进行屏幕共享。参考配置

stopScreenShare

  • 功能: 停止屏幕共享
  • 返回值: 无
RTCSDK.stopScreenShare()
  • 补充说明:

回调函数stopScreenShareRslt

startScreenShareRslt

  • 功能: 开启屏幕共享的响应事件
RTCSDK.on("startScreenShareRslt", ({ sdkErr }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义

stopScreenShareRslt

  • 功能: 停止屏幕共享的响应事件
RTCSDK.on("stopScreenShareRslt", ({ sdkErr }) => {})
参数 类型 说明
sdkErr number 错误码,详细见错误码定义

notifyScreenShareStarted

  • 功能: 通知他人开启了屏幕共享
RTCSDK.on("notifyScreenShareStarted", ({ sharerID }) => {})
参数 类型 说明
sharerID string 开启者的userID
  • 补充说明:

收到该通知即可渲染屏幕共享组件

notifyScreenShareStopped

  • 功能: 通知他人停止了屏幕共享
RTCSDK.on("notifyScreenShareStopped", ({ oprUserID }) => {})
参数 类型 说明
oprUserID string 操作者的userID

notifyScreenMarkStarted

  • 功能: 通知屏幕标注开始
RTCSDK.on("notifyScreenMarkStarted", () => {})

notifyScreenMarkStopped

  • 功能: 通知屏幕标注停止
RTCSDK.on("notifyScreenMarkStopped", () => {})

createLocMixer

  • 功能: 创建本地混图器
  • 返回值: 错误码
RTCSDK.createLocMixer(mixerID, mixerCfg, mixerContents)
参数 类型 说明
mixerID string 混图器唯一标识
mixerCfg object 混图器规格配置,MixerCfg
mixerContents array 混图器内容配置,Array<MixerCotent>
  • 补充说明:

创建本地混图器(用于本地录制、本地推流),当需要多个不同内容的录制、或直播时,就要创建多个混图器 。混图器开消比较大,多个同样图像的输出应该有一个混图器加上多个输出实现;

updateLocMixerContent

  • 功能: 更新本地混图器内容
  • 返回值: 错误码
RTCSDK.updateLocMixerContent(mixerID, mixerContents)
参数 类型 说明
mixerID string 混图器唯一标识
mixerContents array 混图器内容配置,Array<MixerCotent>

destroyLocMixer

  • 功能: 消毁本地混图器
  • 返回值: 无
RTCSDK.destroyLocMixer(mixerID)
参数 类型 说明
mixerID string 混图器唯一标识
  • 补充说明:

消毁本地混图器后, 基于此混图器的录制输出、直播推流输出将自动结束

getLocMixerState

RTCSDK.getLocMixerState(mixerID)
参数 类型 说明
mixerID string 混图器唯一标识

addLocMixerOutput

  • 功能: 开启本地录制、开启直播推流
  • 返回值: 错误码
RTCSDK.addLocMixerOutput(mixerID, MixerOutPutCfgs)
参数 类型 说明
mixerID string 混图器唯一标识
MixerOutPutCfgs Array<MixerOutPutCfg> 本地输出对象

rmLocMixerOutput

  • 功能: 停止本地录制、直播推流
  • 返回值: 无
RTCSDK.rmLocMixerOutput(mixerID, nameOrUrls)
参数 类型 说明
mixerID string 混图器唯一标识
nameOrUrls Array<String> 要停止的录制文件名或直播url列表
  • 补充说明:

所有输出停止后并不会消毁混图器,如果混图器不再需要请手工消毁

setPicResource

  • 功能: 添加图片资源
  • 返回值: 无
RTCSDK.setPicResource(resId, picPath)
参数 类型 说明
resId string 资源唯一标识
picPath string 资源文件路径,为空代表移除资源

locMixerStateChanged

  • 功能: 本地混图器状态变化通知
RTCSDK.on("locMixerStateChanged", ({ mixerID, state }) => {})
参数 类型 说明
mixerID string 混图器唯一标识
state number 混图器状态

locMixerOutputInfo

  • 功能: 本地录制文件、本地直播信息通知
RTCSDK.on("locMixerOutputInfo", ({ mixerID, nameOrUrl, outputInfo }) => {})
参数 类型 说明
mixerID string 混图器唯一标识
nameOrUrl string 录像名称、或直播url
outputInfo object 通知内容,参见MixerOutputInfo

notifyRecordFileStateChanged

  • 功能: 通知录制文件状态更改
RTCSDK.on("notifyRecordFileStateChanged", ({ fileName, state }) => {})
参数 类型 说明
fileName string 文件名
state number 状态,0未上传,1上传中,2已上传,3上传失败

notifyRecordFileUploadProgress

  • 功能: 通知录制文件上传进度
RTCSDK.on("notifyRecordFileUploadProgress", ({ fileName, percent }) => {})
参数 类型 说明
fileName string 文件名
percent number 进度0-100

createCloudMixer

  • 功能: 开始云端录制、云端直播
  • 返回值: 云端混图器ID
RTCSDK.createCloudMixer(cfg)
参数 类型 说明
cfg object 云端混图器配置,参见CloudMixerCfgObj
  • 补充说明:

可以开启多个云端混图器,具体个数和企业购买的授权相关;
开启云端混图器后,房间内所有人都将收到cloudMixerStateChanged通知状态值为1;
云端混图器部署有少量耗时,如果在部署过程遇到异常,将收到createCloudMixerFailed回调;
云端混图器启动完成并进入录制或推流状态时,将收到cloudMixerStateChanged通知状态值为2;
开启云端混图器在进入工作中的状态后,可以通过updateCloudMixerContent更新内容;
混图器如果在工作中遇到异常而停止时,将收到cloudMixerStateChanged通知,状态值为0,并携带错误原因;

updateCloudMixerContent

  • 功能: 更新云端录制、云端直播内容
  • 返回值: 错误码
RTCSDK.updateCloudMixerContent(mixerID, cfg)
参数 类型 说明
mixerID string 混图器ID, 参见createCloudMixer
cfg object 云端混图器配置,参见CloudMixerCfgObj
  • 补充说明:

更新混图器内容时,只能更新内容和布局,不能更改混图器规格、输出目标;
更新混图器内容时,房间内所有人都将收到cloudMixerInfoChanged通知;

destroyCloudMixer

  • 功能: 停止云端录制、云端直播
  • 返回值: 无
RTCSDK.destroyCloudMixer(mixerID)
参数 类型 说明
mixerID string 混图器ID, 参见createCloudMixer

getCloudMixerInfo

  • 功能: 获取云端录制、云端直播信息
  • 返回值: CloudMixerInfo
RTCSDK.getCloudMixerInfo(mixerID)
参数 类型 说明
mixerID string 混图器ID, 参见createCloudMixer

getAllCloudMixerInfo

  • 功能: 获取房间内所有云端录制、云端直播信息
  • 返回值: CloudMixerInfo[]
RTCSDK.getAllCloudMixerInfo()

createCloudMixerFailed

  • 功能: 启动云端录制、云端直播失败通知
RTCSDK.on("createCloudMixerFailed", ({ mixerID, sdkErr }) => {})
参数 类型 说明
mixerID string 混图器ID, 参见createCloudMixer
sdkErr number 错误码,详细见错误码定义

cloudMixerStateChanged

  • 功能: 云端录制、云端直播状态变化通知
RTCSDK.on("cloudMixerStateChanged", ({ mixerID, state, exParam, operUserID }) => {})
参数 类型 说明
mixerID string 混图器ID, 参见createCloudMixer
state number 录制状态,参见MIXER_STATE
exParam object state为0时,包含err字段(取值为错误码), errDesc字段;state为2时,内容参见CloudMixerCfgObj
operUserID string 操作者用户ID

cloudMixerOutputInfoChanged

  • 功能: 云端录制文件、云端直播输出变化通知
RTCSDK.on("cloudMixerOutputInfoChanged", ({ mixerID, outputInfo }) => {})
参数 类型 说明
mixerID string 混图器ID, 参见createCloudMixer
outputInfo object 请参见CloudMixerOutputInfo

cloudMixerInfoChanged

  • 功能: 云端录制、云端直播配置变化通知
RTCSDK.on("cloudMixerInfoChanged", ({ mixerID }) => {})
参数 类型 说明
mixerID string 混图器ID, 参见createCloudMixer
  • 补充说明:

可调用:getCloudMixerInfo获取相关信息