组件与API
组件
Windows sdk提供如下COM组件
组件名称 | ClassID | 描述 |
---|---|---|
CloudroomVideoSDK | {07EFD662-A1BB-4d8d-9BEE-F7E43E5FEBF5} | 核心组件,SDK的用户鉴权、房间管理、队列呼叫、房间相关的功能 单例组件,整个程序的生命过程中只能有有一个实例。 |
CloudroomBoardUI | {D9ED4651-4461-458a-99F4-A455977582FF} | 白板显示、操作组件 |
CloudroomMediaUI | {93A618D5-2535-42d0-B72B-95705263F398} | 影音播放显示组件 |
CloudroomScreenShareUI | {6FF142C5-8A36-49d7-B627-D60B803550FC} | 屏幕共享显示、远程控制、标注组件 |
CloudroomVideoUI | {8A6BBBDC-C6BE-4a47-92F3-F9581C3FB95E} | 摄像头画面显示组件 |
API
房间外接口 | 基础函数 |
初始化/反初始化 | |
登录/注销 | |
队列管理 | |
透明通道/呼叫排队 | |
邀请 | |
房间管理 | |
http上传下载管理组件 | |
房间内接口 | 进出房间 |
房间内基础消息 | |
房间成员管理 | |
房间、用户属性 | |
音频管理 | |
视频管理 | |
屏幕共享 | |
影音共享 | |
本地录制/本地直播 | |
云端录制/互动直播 | |
电子白板/文档共享 |
基础函数
方式 | 接口 | 描述 | 所属组件 |
---|---|---|---|
主调 | Version | 获取SDK版本号 | CloudroomVideoSDK |
sdkPath | 获取sdk所在的目录 | ||
setFileUploadRate | 文件上传的流量控制 | ||
setFileDownloadRate | 文件下载的流量控制 | ||
enableLog2File | 设置是否开启日志 | ||
enableLogReport | 设置是否开启日志上报 | ||
setSDKParams | 设置SDK参数 | ||
setAliyunOssAccountInfo | 设置阿里云OSS信息 | ||
isIEProtectedMode | 查询插件是否运行在“IE保护模式下” | ||
getWriteablePathInIEProtectedMode | 获得一个在保护模式下可读写的目录 | ||
tryReadFile | 尝试读文件 | ||
readFileAsBase64 | 读取文件并以base64编码读取到的内容,返回编码后的文件内容 | ||
readFileData | 读取文件并返回读取到的文件内容 | ||
writeBase64ToFile | 将字符串Base64编码后,写入文件 | ||
getOpenFileName | 获取打开文件的文件名 | ||
getSaveFileName | 获取保存文件的文件名 | ||
getFileSize | 获取文件大小 | ||
deleteFile | 删除文件 | ||
moveFile | 移动文件 |
初始化/反初始化
方式 | 接口 | 描述 | 所属组件 |
---|---|---|---|
主调 | init_2 | SDK初始化 | CloudroomVideoSDK |
uninit | SDK反初始化 |
登录/注销/掉线
方式 | 接口 | 描述 | 所属组件 |
---|---|---|---|
主调 | setServerAddr | 设置服务器地址 | CloudroomVideoSDK |
serverAddr | 获取服务器地址 | ||
login | 密码登录 | ||
loginByToken | Token登录 | ||
updateToken | 更新Token | ||
logout | 注销 | ||
getUserAuthErrCode | 获取第三方鉴权失败码 | ||
getUserAuthErrDesc | 获取第三方鉴权失败描述 | ||
回调 | loginSuccess | 登陆成功 | |
loginFail | 登录失败 | ||
lineOff | 掉线 | ||
notifyTokenWillExpire | Token即将失效 |
队列管理
方式 | 接口 | 描述 | 所属组件 |
---|---|---|---|
主调 | initQueueDat | 初始化队列 | CloudroomVideoSDK |
refreshAllQueueStatus | 刷新所有队列状态 | ||
getAllQueueInfo | 查询队列 | ||
getQueueStatus | 获取队列状态 | ||
getQueuingInfo | 获取我的排队信息 | ||
getServingQueues | 获取我服务的所有队列 | ||
getSessionInfo | 获取我的会话信息 | ||
startQueuing2 | 开始排队 | ||
stopQueuing | 停止排队 | ||
startService2 | 开始服务队列 | ||
stopService | 停止服务队列 | ||
reqAssignUser | 请求分配一个客户 | ||
acceptAssignUser | 接受分配的客户 | ||
rejectAssignUser | 拒绝分配的客户 | ||
回调 | initQueueDatRslt | 列初始化操作结果 | |
queueStatusChanged | 队列状态变化通知 | ||
queuingInfoChanged | 排队信息变化通知 | ||
startQueuingRslt | 开始排队通知 | ||
stopQueuingRslt | 停止排队通知 | ||
startServiceRslt | 开始服务队列通知 | ||
stopServiceRslt | 停止服务队列通知 | ||
responseAssignUserRslt | 响应分配客户操作结果 | ||
autoAssignUser | 自动分配用户通知 | ||
reqAssignUserRslt | 请求分配用户结果 | ||
cancelAssignUser | 分配用户被取消 |
透明通道/呼叫排队
邀请
方式 | 接口 | 描述 | 所属组件 |
---|---|---|---|
主调 | invite | 发送邀请 | CloudroomVideoSDK |
acceptInvite | 接受对方发送的邀请 | ||
rejectInvite | 拒绝对方发送的邀请 | ||
cancelInvite | 取消自己发送的邀请 | ||
回调 | inviteSuccess | 发送邀请成功 | |
inviteFail | 发送邀请失败 | ||
cancelInviteSuccess | 取消自己发送的邀请成功 | ||
cancelInviteFail | 取消自己发送的邀请失败 | ||
acceptInviteSuccess | 接受对方发送的邀请成功 | ||
acceptInviteFail | 接受对方发送的邀请失败 | ||
rejectInviteSuccess | 拒绝对方发送的邀请成功 | ||
rejectInviteFail | 拒绝对方发送的邀请失败 | ||
notifyInviteIn | 通知有人邀请 | ||
notifyInviteAccepted | 通知邀请被对方接受 | ||
notifyInviteRejected | 通知邀请被对方拒绝 | ||
notifyInviteCanceled | 通知有邀请被取消 |
房间管理
方式 | 接口 | 描述 | 所属组件 |
---|---|---|---|
主调 | createMeeting2 | 创建房间 | CloudroomVideoSDK |
destroyMeeting | 销毁房间 | ||
getMeetings | 获取房间列表 | ||
getMeetings2 | 获取房间列表 | ||
回调 | createMeetingSuccess | 创建房间成功 | |
createMeetingFail | 创建房间失败 | ||
destroyMeetingRslt | 销毁房间响应 | ||
getMeetingsSuccess | 获取房间列表成功 | ||
getMeetingsFail | 获取房间列表失败 |
http上传下载管理组件
方式 | 接口 | 描述 | 所属组件 |
---|---|---|---|
主调 | startMgr | 开启http文档上传下载功能 | CloudroomVideoSDK |
stopMgr | 停止http文档上传下载功能 | ||
getAllTransferInfos | 获取所有本地上传、下载文件信息 | ||
getTransferInfo | 获取本地指定文件的上传、下载文件信息 | ||
startTransferFile | 开始/取消传输文件 | ||
cancelFileTransfer | 取消传输 | ||
rmTransferInfo | 删除传输记录 | ||
回调 | fileStateChanged | 通知用户文件状态更改 | |
fileProgress | 通知文件传输(上传/下载)进度 | ||
fileFinished | 通知用户文件传输结束 | ||
fileHttpRspHeader | 通知http响应消息的header数据 | ||
fileHttpRspContent | 通知上传完成后,http的响应内容 |
进出房间
方式 | 接口 | 描述 | 所属组件 |
---|---|---|---|
主调 | enterMeeting | 进入房间 | CloudroomVideoSDK |
stopMeeting | 停止会议,离开房间 | ||
exitMeeting | 退出房间,离开房间 | ||
kickout | 踢出房间,离开房间 | ||
回调 | enterMeetingRslt | 进入房间结果 | |
userEnterMeeting | 有人进入房间通知 | ||
userLeftMeeting | 有人离开房间通知 | ||
meetingDropped | 离开房间通知 | ||
meetingStopped | 离开房间通知 |
房间内基础消息
方式 | 接口 | 描述 | 所属组件 |
---|---|---|---|
主调 | getVideoWallMode2 | 获取视频墙当前分屏模式 | CloudroomVideoSDK |
mainVideo | 获取当前哪个用户为主视频 | ||
setVideoWallMode2 | 设置视频墙分屏模式 | ||
switchtopage | 功能切换 | ||
getcurrentmainpage | 获取当前主功能区 | ||
getcurrentsubpage | 获取当前子页面 | ||
回调 | notifyVideoWallMode2 | 会话内视频分屏模式通知 | |
notifyMainVideoChanged | 会话内主视频变化通知 | ||
notifySwitchToPage | 会话内主功能页切换通知 | ||
netStateChanged | 通知我的网络变化 |
房间成员管理
方式 | 接口 | 描述 | 所属组件 |
---|---|---|---|
主调 | getAllMembers | 获取房间内所有人员 | CloudroomVideoSDK |
getMemberInfo | 获取指定人员信息 | ||
getMemberNickName | 设置指定人昵称 | ||
isUserInMeeting | 检查某人是否在房间里 | ||
setNickName | 设置指定人的昵称 | ||
回调 | setNickNameRsp | 设置指定人昵称响应 | |
notifyNickNameChanged | 用户昵称变更通知 |
房间、用户属性
方式 | 接口 | 描述 | 所属组件 |
---|---|---|---|
主调 | getMeetingAllAttrs | 获取房间属性 | CloudroomVideoSDK |
setMeetingAttrs | 设置房间信息 | ||
addOrUpdateMeetingAttrs | 增加或者更新房间属性 | ||
delMeetingAttrs | 删除特定房间属性 | ||
clearMeetingAttrs | 清除房间属性 | ||
getUserAttrs | 获取用户属性 | ||
setUserAttrs | 设置用户属性 | ||
addOrUpdateUserAttrs | 增加或者更新房间属性 | ||
delUserAttrs | 删除特定用户的特定属性 | ||
clearUserAttrs | 清除特定用户的所有属性 | ||
clearAllUserAttrs | 清除所有用户的属性 | ||
sendMeetingCustomMsg | 房间内发送广播消息 | ||
回调 | getMeetingAllAttrsSuccess | 成功获取到房间属性 | |
getMeetingAllAttrsFail | 获取房间属性失败 | ||
setMeetingAttrsRslt | 设置房间属性结果 | ||
addOrUpdateMeetingAttrsRslt | 增加或更新房间属性结果 | ||
delMeetingAttrsRslt | 删除房间属性结果 | ||
clearMeetingAttrsRslt | 清除房间属性结果 | ||
getUserAttrsSuccess | 获取用户属性 | ||
getUserAttrsFail | 获取用户属性失败 | ||
setUserAttrsRslt | 设置用户属性结果 | ||
addOrUpdateUserAttrsRslt | 增加或更新用户属性结果 | ||
delUserAttrsRslt | 删除用户属性结果 | ||
clearAllUserAttrsRslt | 删除所有用户的属性 | ||
notifyMeetingAttrsChanged | 房间属性发生改变 | ||
notifyUserAttrsChanged | 用户属性发生改变 | ||
sendMeetingCustomMsgRslt | 发送房间内用户广播结果 | ||
notifyMeetingCustomMsg | 接收到房间内用户自定义广播 |
音频管理
方式 | 接口 | 描述 | 所属组件 |
---|---|---|---|
主调 | getAudioMicNames | 麦克风设备列表 | CloudroomVideoSDK |
getAudioSpkNames | 扬声器设备列表 | ||
setAudioCfg | 麦克风设置 | ||
getAudioCfg | 获取麦克风设置 | ||
getMicEnergy | 麦克风声音大小 | ||
openMic | 打开麦克风 | ||
closeMic | 关闭麦克风 | ||
getAudioStatus | 麦克风状态 | ||
micVolume | 获取麦克风音量 | ||
speakerVolume | 获取扬声器音量 | ||
setSpeakerMute | 设置扬声器静音 | ||
speakerMute | 获取扬声器静音状态 | ||
setAllAudioClose | 关闭所有人麦克风 | ||
startGetAudioPCM | 开始获取语音pcm数据 | ||
stopGetAudioPCM | 停止获取语音pcm数据 | ||
回调 | audioDevChanged | 麦克风设备变化 | |
audioStatusChanged | 麦克风状态变化 | ||
micEnergyUpdate | 麦克风声音变化 | ||
notifyAudioPCMDat | 通知语音PCM数据 | ||
notifyAllAudioClose | 通知关闭音频 |
视频管理
屏幕共享
影音共享
方式 | 接口 | 描述 | 所属组件 |
---|---|---|---|
主调 | setMediaCfg | 设置影音共享配置 | CloudroomVideoSDK |
getMediaCfg | 获取影音共享参数 | ||
startPlayMedia | 开始播放影音 | ||
mediaVolume | 获取播放音量 | ||
pausePlayMedia | 暂停或恢复播放影音 | ||
stopPlayMedia | 停止播放影音 | ||
setMediaplaypos | 设置播放进度 | ||
getmediainfo | 影音播放信息 | ||
getmediaimg | 获取影音图像数据 | ||
keepAspectRatio | 是否保持宽高缩放比例 | CloudroomMediaUI | |
dblClickFullScreen | 是否双击全屏 | ||
disableToolBar | 禁用工具栏 | ||
savePicToFile | 保存当前画面到文件 | ||
savePicToBase64 | 当前画面数据转换成base64,以便传输 | ||
getPicFrameTime | 获取当前图像帧的显示时间戳 | ||
setToolBarUIElementVisible | 显示隐藏播放工具条上的界面元素 | ||
setToolBarSize | 设置影音工具条的大小 | ||
disableChangePlayPos | 禁止调整播放位置 | ||
setFullScreen | 设置全屏 | ||
getFullScreen | 是否全屏 | ||
回调 | notifyMediaOpened | 通知影音文件打开 | CloudroomVideoSDK |
notifyMediaStart | 通知影音开始播放 | ||
notifyMediaStop | 通知影音播放停止 | ||
notifyMediaPause | 通知影音播放是否暂停 | ||
notifyPlayPosSetted | 通知更新影音播放进度 |
本地录制/本地直播
方式 | 接口 | 描述 | 所属组件 |
---|---|---|---|
主调 | createLocMixer | 创建本地混图器 | CloudroomVideoSDK |
updateLocMixerContent | 更新本地混图器内容 | ||
destroyLocMixer | 消毁本地混图器 | ||
getLocMixerState | 获取本地混图器状态 | ||
addLocMixerOutput | 开启本地录制、直播推流 | ||
rmLocMixerOutput | 停止本地录制、直播推流 | ||
getAllRecordFiles | 录制文件列表 | ||
getRecordFileInfo | 获取录制文件信息 | ||
cancelUploadRecordFile | 取消上传录像文件 | ||
uploadRecordFile | 上传录像文件 | ||
uploadRecordFile2 | 上传录像文件 | ||
addFileToRecordMgr | 添加文件到录制管理器 | ||
removeFromRecordMgr | 从录制管理器删除文件 | ||
playbackRecordFile | 回放录制文件 | ||
setMarkText | 添加打点信息 | ||
removeMarkText | 移除打点信息 | ||
getAllMarks | 获取所有打点信息 | ||
getVideoMarkFile | 获取打点文件的绝对文件路径名 | ||
回调 | locMixerStateChanged | 本地录制、本地直播状态变化通知 | |
locMixerOutputInfo | 本地录制文件、本地直播信息通知 | ||
notifyRecordFileStateChanged | 通知文件上传状态 | ||
notifyRecordFileUploadProgress | 通知上传录制文件进度 | ||
uploadRecordFileErr | 录制文件上传错误 |
云端录制/互动直播
方式 | 接口 | 描述 | 所属组件 |
---|---|---|---|
主调 | startSvrMixer | 开始云端录制、云端直播 | CloudroomVideoSDK |
updateSvrMixerContent | 更新云端录制、云端直播内容 | ||
stopSvrMixer | 停止云端录制、云端直播 | ||
getSvrMixerState | 获取云端录制、云端直播状态 | ||
回调 | svrMixerStateChanged | 云端录制、云端直播状态变化通知 | |
startSvrMixerFailed | 启动云端录制失败通知 | ||
svrMixerCfgChanged | 云端录制、云端直播配置变化通知 | ||
svrMixerOutputInfo | 云端录制文件、云端直播输出变化通知 |
电子白板/文档共享
接口详情
string Version
- 功能: SDK版本号
string sdkPath
- 功能: 获取sdk所在的目录
void enableLog2File(int bEnable)
功能: 设置是否开启日志
返回值:无
参数 | 类型 | 含义 |
---|---|---|
bEnable | int | 1表示开启日志,0表示不开启日志 |
SDK中日志功能默认是打开的,这个接口在init或init2之前可调用
void enableLogReport(int bEnable)
功能: 设置是否开启日志上报
返回值:无
参数 | 类型 | 含义 |
---|---|---|
bEnable | int | 1表示开启日志上报,0表示不开启日志上报 |
SDK中日志上报默认是打开的,这个接口在init或init2之前可调用
void setSDKParams(string jsonVal)
功能: 设置SDK参数
返回值:无
参数:json格式,具体可用参数如下:
//使用格式如下:
{"NoQueue": 0}
参数 | 取值 | 含义 |
---|---|---|
NoQueue | 0/1(缺省:0) | 设为1可加快登录速度(适合于不使用sdk的排队功能的业务,如:临柜双录业务、链接入 会业务) |
Timeout | (缺 省:90000) | 网络通信超时时间,单位是毫秒 |
DatEncType | 0/1 (缺省:1) | 数据加密类型(0:敏感数据加密,1:全面加密) |
这个接口在init之前调用有效
void setFileUploadRate(int maxbps)
功能: 文件上传的流量控制(SDK默认不开启流控,目前对文件上传控制的功能有:录制文件上传、网盘文件上传。)
返回值:无
参数 | 类型 | 含义 |
---|---|---|
maxbps | int | 每秒上传的最大字节数,小于等于0表示不开启流控 |
void setFileDownloadRate(int maxBytePerSec)
功能: 文件下载的流量控制
返回值:无
参数 | 类型 | 含义 |
---|---|---|
maxBytePerSec | int | 每秒下载的最大字节数。-1代表不进行流控 |
void setAliyunOssAccountInfo(string accessKey,string accessSecret)
功能: 设置阿里云OSS信息
返回值:无
参数 | 类型 | 含义 |
---|---|---|
accessKey | string | 用于标示用户 |
accessSecret | string | 用户用于加密签名字符串和OSS用来验证签名字符串的密钥 |
参考阿里云的用户签名验证相关文档 :https://help.aliyun.com/document_detail/31950.html?spm=a2c4g.11186623.6.707.44c0734ctzHsOa
int init_2(string sdkDatSavePath )
功能: 登录
返回值:返回错误码(错误码为CRVIDEOSDK_NOERR表示没有错误)(int)
参数 | 类型 | 含义 |
---|---|---|
sdkDatSavePath | string | SDK工作目录,用于存储配置文件、临时文件、录制文件、影音文件、日志等文件,如果传空值,则默认为sdk的安装目录 |
- 注意:程序开始时需要调用init_2,程序结束时调用uninit,整个程序的生命周期中只进行一次初始化和反初始化。
- 注意目录的读写权限,如果目录只读,则无法在此目录下生成其他文件和文件夹
void uninit()
功能: SDK反初始化
返回值:无
参数:无
void setServerAddr(string serverList)
- 功能: 设置服务器地址
- 返回值:无
参数 | 类型 | 含义 |
---|---|---|
serverList | string | 服务器地址,多个服务器地址使用分号隔开(如:www.cloudroom.com:8080;183.60.47.52:8080;) |
string serverAddr
- 功能: 获得设置的服务器地址
void login(string appID, string md5_appSecret, string nickName, string userID, string userAuthCode, string cookie)
- 功能: 密码登录
- 返回值:无
参数 | 类型 | 含义 |
---|---|---|
appID | string | appID用于区分不同的项目,每个项目都有属于自己的唯一的appID,不同appID的项目完全独立,无法相互通信。appID请联系云屋销售获取,并开通相关套餐和功能权限。 |
md5_appSecret | string | appID对应的密码(md5加密传给sdk),可登录云屋管理后台修改。 |
nickName | string | 昵称 |
userID | string | 用户ID。和云屋系统无关,业务方自由填写,保证唯一性即可(同一appID下,具有唯一性即可) |
userAuthCode | string | 默认填空。只有开启第三方认证才需要填写。(开启第三方认证时,云屋SDK服务器将连接提前配好的业务方服务器进行实时验证。) |
cookie | string | 可为空字符串。详细介绍见关键词 |
登陆成功则回调loginSuccess,登陆失败则回调loginFail
void loginByToken(string token, string nickName, string userID, string userAuthCode, string cookie)
- 功能: Token登录
- 返回值:无
参数 | 类型 | 含义 |
---|---|---|
token | string | Token鉴权码 |
nickName | string | 昵称 |
userID | string | 用户ID。和云屋系统无关,业务方自由填写,保证唯一性即可(同一appID下,具有唯一性即可) |
userAuthCode | string | 默认填空。只有开启第三方认证才需要填写。(开启第三方认证时,云屋SDK服务器将连接提前配好的业务方服务器进行实时验证。) |
cookie | string | 可为空字符串。详细介绍见关键词 |
登陆成功则回调loginSuccess,登陆失败则回调loginFail
void loginSuccess(string usrID, string cookie)
功能: 登录成功回调
返回值:无
参数 | 类型 | 含义 |
---|---|---|
usrID | string | 用户ID |
cookie | string | 详细介绍见关键词 |
void loginFail(CRVIDEOSDK_ERR_DEF sdkErr, string &cookie)
- 功能: 登录失败回调,登录出错,可以弹出错误提示,或调用登录接口再次重试登录
参数 | 类型 | 含义 |
---|---|---|
sdkErr | int | 错误码 |
cookie | string | 详细介绍见关键词 |
如果启用了第三方鉴权,并在鉴权失败时(sdkErr为CRVIDEOSDK_CUSTOMAUTH_FAILED),可以通过getUserAuthErrCode、getUserAuthErrDesc获取详细原因。
void updateToken(string &token)
- 功能: 更新Token(在Token即将失效的时候更新Token延长有限时间)
参数 | 类型 | 含义 |
---|---|---|
token | string | Token鉴权码 |
int getUserAuthErrCode()
功能: 获取第三方鉴权失败码(只有在登录失败原因为:CRVIDEOSDK_CUSTOMAUTH_FAILED时有效)
返回值: 第三方返回的失败码
string getUserAuthErrDesc()
功能: 获取第三方鉴权失败原因描述(只有在登录失败原因为:CRVIDEOSDK_CUSTOMAUTH_FAILED时有效)
返回值: 第三方返回的描述串
void logout()
功能: 注销
返回值: 无
退出程序时,必须注销本次登录,然后再进行SDK反初始化操作
string getAllMembers()
功能: 房间成员列表
返回值:返回含多个成员信息,json格式,参见MembersObj
string getMemberInfo(string userID)
功能: 返回房间内指定成员信息
返回值: userID的成员信息,json格式,参见MemberObj
参数 | 类型 | 含义 |
---|---|---|
userid | string | 用户ID |
string getMemberNickName(string userID)
功能: 房间成员昵称
返回值:用户userID的昵称(string)
参数 | 类型 | 含义 |
---|---|---|
userid | string | 用户ID |
bool isUserInMeeting(string userID)
功能: 用户是否在房间中
返回值:如果用户存在则返回true,否则返回false(bool)
参数 | 类型 | 含义 |
---|---|---|
userid | string | 用户ID |
strNickName | string | 新的用户昵称 |
void setNickName(string userid, string strNickName)
功能: 设置某个用户的昵称
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userid | string | 用户ID |
strNickName | string | 新的用户昵称 |
回调函数 setNickNameRsp 调用此接口如果设置成功,其他会话用户会收到 notifyNickNameChanged
string getScreenShareCfg()
功能: 获取屏幕共享配置
返回值:屏幕共享配置,json格式,参见screenShareCfgObj
void setScreenShareCfg(string jsonCfg)
功能: 设置屏幕共享配置
返回值:无
参数 | 类型 | 含义 |
---|---|---|
string | ScreenShareCfgObj | 屏幕共享配置 |
void startScreenShare()
功能: 开启屏幕共享
返回值:无
void stopScreenShare()
功能: 停止屏幕共享
返回值:无
void rejectShareRequestion(string requesterId, string param)
功能: 拒绝分享请求
返回值:无
参数 | 类型 | 含义 |
---|---|---|
requesterId | string | 请求者的用户ID |
param | string | 额外参数,可不填 |
void setCustomizeScreenImg(video_FORMAT format, int width, int heigh, string dat)
功能: 自定义的抓屏图像数据
返回值:无
参数 | 类型 | 含义 |
---|---|---|
format | video_FORMAT | 视频格式 |
width | int | 图像的宽度 |
heigh | int | 图像的高度 |
dat | string | 承载argb数据,base64编码 |
void giveCtrlRight(string userID)
功能: 赋予控制权限
返回值:无
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户ID |
void releaseCtrlRight(string userID)
功能: 收回控制权限
返回值:无
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户ID |
void sendMouseCtrlMsg(MOUSE_MSG_TYPE msgType,MOUSE_KEY_TYPE mouseMsgType, int x, int y)
功能: 发送鼠标控制消息
返回值:无
参数 | 类型 | 含义 |
---|---|---|
msgType | MOUSE_MSG_TYPE | 鼠标事件类型 |
mouseMsgType | MOUSE_KEY_TYPE | 鼠标键类型 |
x | int | 鼠标在屏幕中的横坐标 |
y | int | 鼠标在屏幕中的纵坐标 |
void sendKeyCtrlMsg(KEY_MSG_TYPE keyMsgType, int vk, int bExtendedKey)
功能: 发送键盘控制消息
返回值:无
参数 | 类型 | 含义 |
---|---|---|
keyMsgType | KEY_MSG_TYPE | 键盘事件类型 |
vk | int | 键盘虚拟键值 |
bExtendedKey | int | 是否是扩展按键 |
string getShareScreenDecodeImg()
功能: 屏幕共享图像数据
返回值:获取屏幕共享图像数据。json格式,参见(VideoImgObj)
void startScreenShareRslt(int sdkErr)
- 功能: 开启屏幕共享的响应事件
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkEr | int | 错误码 |
void stopScreenShareRslt(int sdkErr)
- 功能停止屏幕共享的响应事件
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkEr | int | 错误码 |
void notifyRequestShare(const string& sharerId, const string& requesterId, const string& param)
- 功能:SDK通知请求屏幕共享
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sharerId | string | 共享者ID |
requesterId | string | 请求者ID |
param | string | 自定义参数 |
void notifyCancelShareRequestion(const string& sharerId, const string& requesterId)
- 功能:SDK通知取消屏幕共享请求
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sharerId | string | 请求者ID |
requesterId | string | 共享者ID |
void notifyRejectShareRequestion(const string& requesterId, const string& sharerId, const string¶m)
- 功能:SDK通知拒绝屏幕共享请求
- 参数:
参数 | 类型 | 含义 |
---|---|---|
requesterId | string | 请求者ID |
sharerId | string | 共享者ID |
param | string | 自定义参数 |
void requestShare(int sharerId, string param)
功能: 请求某人开启屏幕共享
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sharerId | int | 需要开启共享的用户ID |
param | string | 自定义参数,可传空字符串 |
void cancelShareRequestion(int sharerId)
功能: 取消屏幕共享请求
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sharerId | int | 需要取消的共享者ID,与requestShare的参数对应 |
void rejectShareRequestion(int requesterId, string param)
功能: 拒绝分享请求
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
requesterId | int | 请求者ID |
param | string | 自定义参数,可传空字符串 |
void notifyScreenShareStarted(string userID)
- 功能:通知他人开启了屏幕共享
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userID | string | 开启共用的用户ID |
void notifyScreenShareStopped()
- 功能: 通知他人停止了屏幕共享
void notifyScreenShareData(const string &userID, const string &datInfo)
- 功能:通知对端屏幕图像有变化
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户ID |
datInfo | string | 变化的区域;(可以只重绘这块区域) |
void notifyCatchScreen()
- 功能:自定义抓屏时,SDK通知使用者抓屏(在收到通知时, 一定要及时setCustomizeScreenImg,如果没图像时,可以先送入空图像)
void notifyGiveCtrlRight(const string &operId, const string &targetId)
- 功能:SDK通知远程控制权限给予了某人
- 参数:
参数 | 类型 | 含义 |
---|---|---|
operId | string | 操作的用户ID |
targetId | string | 控制权限给予了谁 |
void notifyReleaseCtrlRight(string operId, string targetId )
- 功能:SDK通知收回屏幕共享操作权限
- 参数:
参数 | 类型 | 含义 |
---|---|---|
operId | string | 操作的用户ID |
targetId | string | 收回了谁的控制权限 |
void notifyShareRectChanged(int x, int y, int w, int h)
- 功能:通知屏幕共享大小改变
- 参数:
参数 | 类型 | 含义 |
---|---|---|
x | int | 矩形起始坐标X |
y | int | 矩形起始坐标Y |
w | int | 矩形长 |
h | int | 矩形宽 |
int createLocMixer(string mixerID, string mixerCfg, string mixerContent)
功能: 创建本地混图器
返回值: 错误码
- 参数:
参数 | 类型 | 含义 |
---|---|---|
mixerID | string | 混图器唯一标识 |
mixerCfg | MixerCfgObj | 混图器规格配置,json格式 |
mixerContent | MixerContentObj | 混图器内容配置,json格式 |
int updateLocMixerContent(string mixerID, string mixerContent)
功能: 更新本地混图器内容
返回值: 错误码
- 参数:
参数 | 类型 | 含义 |
---|---|---|
mixerID | string | 混图器唯一标识 |
mixerContent | MixerContentObj | 混图器内容配置,json格式 |
void destroyLocMixer(string mixerID)
功能: 消毁本地混图器
返回值: 无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
mixerID | string | 混图器唯一标识 |
int getLocMixerState(string mixerID)
功能: 获取本地混图器状态
返回值: 返回本地混图器状态,可参考 MIXER_STATE
- 参数:
参数 | 类型 | 含义 |
---|---|---|
mixerID | string | 混图器唯一标识 |
int addLocMixerOutput(string mixerID,string mixerOutput)
功能: 开启本地录制、直播推流
返回值: 错误码
- 参数:
参数 | 类型 | 含义 |
---|---|---|
mixerID | string | 混图器唯一标识,请确保创建了有效的混图器createLocMixer。 |
mixerOutput | MixerOutputObj | 混图器输出配置,json格式 |
- 可以一次添加多个输出,也可以依据业务需要稍后再添加新的输出;
- 多个输出不能同名、或同一url;
- 每个输出,有独立的信息通知,请见事件locMixerOutputInfo.如果输出异常时,将自动停止;
void rmLocMixerOutput(string mixerID, string nameOrUrl)
功能: 停止本地录制、直播推流
返回值: 无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
mixerID | string | 混图器唯一标识 |
nameOrUrl | string | 要停止的录制文件名或直播url,支持多值,以";"分隔; |
注意事项:所有输出停止后并不会消毁混图器,如果混图器不再需要请手工消毁;
string getAllRecordFiles()
功能: 录制文件列表
返回值:返回含多个录制文件信息,请见RecordFileInfoObj
void cancelFileTransfer(string fileName)
功能: 取消传输
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
fileName | string | 本地路径文件名 |
取消时,只是停止了传输任务,不清理记录及断点文件
void cancelUploadRecordFile(string filename)
功能: 取消上传录像文件
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
filename | string | 文件名 |
void uploadRecordFile(string filename)
功能: 上传录像文件
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
filename | string | 文件名 |
上传文件在默认位置
void uploadRecordFile2(string fileName,string svrPathFileName)
功能: 上传录像文件
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
filename | string | 文件名 |
svrPathFileName | string | 服务器路径文件名 |
上传文件到服务器指定位置
void playbackRecordFile(string filename)
功能: 回放录制文件
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
filename | string | 文件名 |
void locMixerStateChanged(string mixerID, int state)
- 功能:SDK通知本地录制、本地直播状态变化
- 参数:
参数 | 类型 | 含义 |
---|---|---|
mixerID | string | 混图器唯一标识 |
state | int | CRVideo_MIXER_STATE |
void locMixerOutputInfo(string mixerID, string nameOrUrl, string outputInfo)
- 功能:SDK通知本地录制文件、本地直播信息通知
- 参数:
参数 | 类型 | 含义 |
---|---|---|
mixerID | string | 混图器唯一标识 |
nameOrUrl | string | 录像名称、或直播url |
outputInfo | string | json结构的字符串,请参见MixerOutputInfoObj |
void notifyRecordFileStateChanged(const string &fileName, int state)
- 功能:SDK通知录制文件状态更改
- 参数:
参数 | 类型 | 含义 |
---|---|---|
fileName | string | 本地文件路径 |
state | int | 状态: 0未上传 1上传中 2已上传 |
void notifyRecordFileUploadProgress(const string &fileName, int percent)
- 功能:SDK通知上传录制文件进度
- 参数:
参数 | 类型 | 含义 |
---|---|---|
fileName | string | 文件名 |
percent | int | 进度0-100 |
void uploadRecordFileErr(const string &fileName, int sdkErr)
- 功能:上传录制文件错误通知
- 参数:
参数 | 类型 | 含义 |
---|---|---|
fileName | string | 本地文件路径 |
sdkEr | int | 操作失败代码,定义见ERR_DEF |
void startSvrMixer(string mutiMixerCfgs, string mutiMixerContents, string mutiMixerOutputs)
功能: 开始云端录制、云端直播
返回值: 错误码
- 参数:
参数 | 类型 | 含义 |
---|---|---|
mutiMixerCfgs | string | 服务器混图配置,请参考MutiMixerCfgsObj |
mutiMixerContents | string | 服务器混图内容,请参考MutiMixerContentsObj |
mutiMixerOutputs | string | 服务器输出,请参考MutiMixerOutputsObj |
注意事项 : 启动云端功能有一定耗时,请关注混图器的状态变化事件svrMixerStateChanged 每个输出有私有的状态变化事件svrMixerOutputInfo
int updateSvrMixerContent(MutiMixerContentsObj mutiMixerContents)
功能: 更新云端录制、云端直播内容
返回值: 错误码
参数 | 类型 | 含义 |
---|---|---|
mutiMixerContents | MutiMixerContentsObj | 服务器混图内容 |
void stopSvrMixer()
功能: 停止云端录制、云端直播
返回值: 无
注意事项 : 停止有有一定耗时,请关注混图器的状态变化事件svrMixerStateChanged 每个输出有私有的状态变化事件svrMixerOutputInfo
int getSvrMixerState()
功能: 获取云端录制、云端直播状态
返回值: MIXER_STATE
void svrMixerStateChanged(int state, int err, const string &operatorID)
- 功能:SDK通知云端录制、云端直播状态变化
- 参数:
参数 | 类型 | 含义 |
---|---|---|
state | int | 状态值请参考CRVideo_MIXER_STATE |
err | int | 错误值请参考ERR_DEF |
operatorID | string | 引起变化的用户id |
int getSvrMixerState()
功能: 获取云端录制、云端直播状态
返回值: MIXER_STATE
void startSvrMixerFailed(int errCode)
- 功能:启动云端录制失败通知
- 参数:
参数 | 类型 | 含义 |
---|---|---|
errCode | int | 错误值请参考ERR_DEF |
void svrMixerCfgChanged()
功能:SDK通知云端录制、云端直播内容变化
参数:无
void svrMixerOutputInfo(const string& outputInfo)
- 功能:SDK通知云端录制文件、云端直播信息变化
- 参数:
参数 | 类型 | 含义 |
---|---|---|
outputInfo | string | 通知内容,json结构,请参见SvrMixerOutputInfoObj |
void createboard(string title, int width, int height, int pageCount)
功能: 创建白板
返回值:白板 boardID
参数 | 类型 | 含义 |
---|---|---|
title | string | 白板名称 |
width | int | 白板宽度 |
height | int | 白板高度 |
pageCount | int | 白板内有多个页(一般空白板1页,文档白板为实际页数 |
其他参会者会收到:notifyCreateBoard事件;同时后台会记录下白板数据,新入会者会收到:notifyInitBoards事件.注意:创建完白板后,一定要及尽快调用initBoardPageDat初始化各页数据
void closeboard(string boardID)
功能: 关闭白板
返回值:无
参数 | 类型 | 含义 |
---|---|---|
boardID | string | 白板标识 |
其他参会者将收到notifyCloseBoard事件;同时后台会移除对应白板的所有信息
string getBoardFilesDir(const string &boardID)
功能: 得到白板文档文件存储目录
返回值:白板文档文件存储目录
参数 | 类型 | 含义 |
---|---|---|
boardID | string | 白板标识 |
void initBoardPageDat(string boardID, int boardPageNo, string imgID,string elemets)
功能: 初始化白板图元数据
返回值:无
参数 | 类型 | 含义 |
---|---|---|
boardID | string | 白板标识 |
boardPageNo | int | 白板第几页(0:代表第一页) |
imgID | string | 白板的背景图片标识(空代表无背影图) |
elemets | string | 白板的初始图元(空代表无图元,一般在导入历史文件才用到) |
- imgID非空时, 代表背景的图片ID。 img来源请参见getNetDiskDocFilePageInfo
- 其他参会者将收到notifyInitBoardPageDat事件;
- 后台会记录下白板的页数据,在新用户入会时,也会收到notifyInitBoardPageDat事件
string createElementID()
功能: 生成白板图元ID
返回值:图元id
本地操作;所有白板图元id,必须由此接口创建;(历史文件存储的图元id,在房间内不能再使用,应重新创建)
void addboardelement(string boardID, int boardPageNo, string element)
功能: 添加图元信息
返回值:无
参数 | 类型 | 含义 |
---|---|---|
boardID | string | 白板标识 |
boardPageNo | int | 白板的页序号(0为第一页) |
element | string | 图元信息,参见json格式之BoardElementObj |
其他参会者会收到:notifyAddBoardElement事件;同时后台会保存图元,新入会者会在notifyInitBoardPageDat中得到这些图元
void modifyBoardElement(string boardID, int boardPageNo, string element)
功能: 修改图元信息
返回值:elementID图元标识(string)
参数 | 类型 | 含义 |
---|---|---|
boardID | string | 白板标识 |
boardPageNo | int | 白板的页序号(0为第一页) |
element | string | 图元信息,参见json格式之 BoardElementObj |
说明:其他参会者会收到:notifyModifyBoardElement事件;同时后台会覆盖对应图元的数据,新入会者会在notifyInitBoardPageDat中得到这些图元
void delboardelement(string boardID, int boardPageNo, string elementIDs)
功能: 删除图元
返回值:无
参数 | 类型 | 含义 |
---|---|---|
boardID | string | 白板标识 |
boardPageNo | int | 白板的页序号(0为第一页) |
elementIDs | string | 图元id列表,多值时,以“;”分隔,如:“id1;id2” |
说明:其他参会者会收到:notifyDelBoardElement事件;同时后台会移除这些图元,新入会者会在notifyInitBoardPageDat中将不包含这些图元
void setmousehotspot(string boardID, int boardPageNo, int x, int y)
功能: 设置白板鼠标热点
返回值:无
参数 | 类型 | 含义 |
---|---|---|
boardID | string | 白板标识 |
boardPageNo | int | 白板的页序号(0为第一页) |
x | int | 屏幕横坐标 |
y | int | 屏幕纵坐标 |
void setBoardCurPageNo(string boardID, int boardPageNo, int pagePos1, int pagePos2)
功能: 白板翻页
返回值:无
参数 | 类型 | 含义 |
---|---|---|
boardID | string | 白板标识 |
boardPageNo | int | 白板的页序号(0为第一页) |
pagePos1 | int | 私有扩展参数1(如可用于页内x方向滚动位置) |
pagePos2 | int | 私有扩展参数2(如可用于页内y方向滚动位置) |
void listNetDiskDocFile(string dir)
功能: 查询文档列表
返回值:无 .查询结果请参见listNetDiskDocFileRslt
参数 | 类型 | 含义 |
---|---|---|
dir | string | 要查询的目录,空或"/"时,代表查询根目录下的内容; |
查询服务器指定目录下的内容(子目录名、上传的文档源文件及文档转换状态)
void uploadDocFileToNetDisk(string svrPathFileName,string locPathFileName)
功能: 上传文档并转换
返回值:无
参数 | 类型 | 含义 |
---|---|---|
svrPathFileName | string | 服务器的路径文件名,包含目录时,服务器自动创建对应目录 |
locPathFileName | string | 要上传文件的本地的路径文件名 |
上传进度请参见notifyNetDiskDocFileTrsfProgress, 转换结果请调用listNetDiskDocFile或者getNetDiskDocFilePageInfo
说明:支持的文件格式有:doc,docx, ppt, pptx, pps, ppsx, xls, xlsx, et, ett, wps, wpt, dps, pdf, txt, log, ini, bmp, png, jpg, jpeg;
void downloadDocSrcFile(string svrPathFileName, string locPathFileName)
功能: 下载源始文档
返回值:无
参数 | 类型 | 含义 |
---|---|---|
svrPathFileName | string | 服务器的路径文件名 |
locPathFileName | string | 文件下载后存放的本地的路径文件名,目录不存在时自动创建 |
void cancelTransforNetDiskDocFile(string svrPathFileName)
功能: 取消文档传输
返回值:无
参数 | 类型 | 含义 |
---|---|---|
svrPathFileName | string | 服务器的路径文件名 |
void deleteNetDiskDocFile(string svrPathFileName)
功能: 删除文档
返回值:无, 删除结果请参见deleteNetDiskDocFileRslt
参数 | 类型 | 含义 |
---|---|---|
svrPathFileName | string | 服务器的路径文件名 |
void getNetDiskDocFilePageInfo(string svrPathFileName)
功能: 获取文档的转换信息
返回值:无, 结果请参见getNetDiskDocFilePageInfoRslt
参数 | 类型 | 含义 |
---|---|---|
svrPathFileName | string | 服务器的路径文件名 |
说明:获取到的文档转换后的信息后, 就可以创建白板createboard, 然后为白板初始化文档内容initBoardPageDat
void downloadNetDiskDocFilePage(string pagePathFileName,string locPathFileName)
功能: 下载文档转换后的页文件
返回值:无, 下载进度请参见notifyNetDiskDocFileTrsfProgress
参数 | 类型 | 含义 |
---|---|---|
pagePathFileName | string | 页文件在服务器的路径文件名 |
locPathFileName | string | 文件下载后存放的本地的路径文件名,目录不存在时自动创建 |
说明:页文件格式: 6字节保留,4字节图像格式(2:jpg, 4:png),4字节图像内容长度,图像内容
void setPicResource(string resourceid, string picJsonVal)
功能: 添加图片资源
返回值:无
参数 | 类型 | 含义 |
---|---|---|
resourceid | string | 资源唯一标识;(可以是guserID,也可以序号方式) |
picJsonVal | object | 资源内容,json格式,详见picResourceObj说明 |
void notifyInitBoards(const string &jsonBoards)
- 功能:SDK入会后通知房间中已经存在的白板列表
- 参数:
参数 | 类型 | 含义 |
---|---|---|
jsonBoards | string | 已经创建好的白板列表, json结构体请参见BoardObjs说明 |
void notifyInitBoardPageDat(const string &boardID, int pageNo, const string &bkImgID, const string &elementDatas, const string &operatorID)
- 功能:通知初始化白板内图元数据
- 参数:
参数 | 类型 | 含义 |
---|---|---|
boardID | string | 白板标识 |
boardPageNo | int | 白板页序号 |
imgID | string | 页背景文件ID(空代表无背景) |
elementDatas | string | 此页的所有图元, json结构体请参见BoardElementObjs |
operatorID | string | 初始化用户(为空时,代表入会时后台事件) |
void notifyCreateBoard(const string &jsonBoard, const string &operatorID)
- 功能:SDK通知创建白板
- 参数:
参数 | 类型 | 含义 |
---|---|---|
jsonBoard | string | 白板信息,json结构体请参见BoardObj |
operatorID | string | 创建白板的用户ID |
void notifyCloseBoard(const string &boardID, const string &operatorID)
- 功能:SDK通知关闭白板
- 参数:
参数 | 类型 | 含义 |
---|---|---|
boardID | string | 白板标识 |
operatorID | string | 关闭白板的用户ID |
void notifyAddBoardElement(const string &boardID, int pageNo, const string &elementData, const string &operatorID)
- 功能:SDK通知添加图元信息
- 参数:
参数 | 类型 | 含义 |
---|---|---|
boardID | string | 白板标识 |
boardPageNo | int | 白板页序号 |
element | string | 此页的所有图元, json格式请参见BoardElementObj |
operatorID | string | 添加图元的用户ID |
void notifyModifyBoardElement(const string &boardID, int pageNo, const string &elementData, const string &operatorID)
- 功能:SDK通知图元信息被修改
- 参数:
参数 | 类型 | 含义 |
---|---|---|
boardID | string | 白板标识 |
boardPageNo | int | 白板页序号 |
element | string | 此页的所有图元, json格式请参见BoardElementObj |
operatorID | string | 添加图元的用户ID |
void notifyDelBoardElement(const string &boardID, int pageNo, const string &elementIDs, const string &operatorID)
- 功能:SDK通知删除图元
- 参数:
参数 | 类型 | 含义 |
---|---|---|
boardID | string | 白板标识 |
boardPageNo | int | 白板页序号 |
elementIDs | string | 图元id列表,以 “;”分隔 |
operatorID | string | 删除图元的用户ID |
void notifyMouseHotSpot(const string&, int pageNo, int, int, const string &)
- 功能:SDK通知设置鼠标热点消息
- 参数:
参数 | 类型 | 含义 |
---|---|---|
e.p_boardID | string | 白板标识 |
e.p_x | int | 屏幕横坐标 |
e.p_y | int | 屏幕纵坐标 |
e.p_operatorID | string | 操作者的用户ID |
void notifyBoardCurPageNo(const string &boardID, int pageNo, int pagePos1, int pagePos2, const string &operatorID)
- 功能:SDK通知通知白板翻页
- 参数:
参数 | 类型 | 含义 |
---|---|---|
boardID | string | 白板标识 |
pageNo | int | 翻到第几页 |
pagePos1 | int | 扩展参数1 |
pagePos2 | int | 扩展参数2 |
operatorID | string | 操作者的用户ID |
void undoEnableChange(bool isEnable)
- 功能:SDK通知白板的“撤消”功能是否可用
- 参数:
参数 | 类型 | 含义 |
---|---|---|
isEnable | bool | 撤消功能是否可用 |
void redoEnableChange(bool isEnable)
- 功能:SDK通知白板的“恢复”功能是否可用
- 参数:
参数 | 类型 | 含义 |
---|---|---|
isEnable | bool | 恢复功能是否可用 |
void listNetDiskDocFileRslt(const string &dir, int sdkErr, const string &rslt)
- 功能 通知查询文档列表结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
dir | string | 查询的目录 |
sdkERR | int | 0代表成功,非0参见ERR_DEF |
rslt | string | 成功时的查询的结果,json格式请参见ListDocFileRsltObj |
void getNetDiskDocFilePageInfoRslt(const string &svrPathFileName, int sdkErr, const string &rslt)
- 功能 通知查询文档转换结果
- 参数
参数 | 类型 | 含义 |
---|---|---|
svrPathFileName | string | 查询的文档名 |
sdkERR | int | 0代表成功,非0参见ERR_DEF |
rslt | string | 成功时的查询的结果,json格式请参见GetDocPageInfoRsltObj |
void deleteNetDiskDocFileRslt(const string &svrPathFileName, int sdkERR)
- 功能: 通知删除文档结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
svrPathFileName | string | 要删除的文档,或页文件名 |
sdkERR | int | 删除结果,0代表删除成功, 错误码取值参考ERR_DEF |
void notifyNetDiskDocFileTrsfProgress(const string &svrPathFileName, int percent)
- 功能 通知文档传输进度
- 参数
参数 | 类型 | 含义 |
---|---|---|
svrPathFileName | string | 传输的文档,或页文件名 |
percent | int | 传输进度(等于100代表传输完成) |
string getOpenFileName(string title, string directory, string filter)
功能:获取用户打开的全路径文件名
返回值: 结果,空串表示用户取消, 否则返回用户选择的文件路径文件名
参数 | 类型 | 含义 |
---|---|---|
title | string | 打开文件框的标题 |
directory | string | 打开对话框初始路径,不设初始值时请传空 |
filter | string | 文件类型过滤器(可为空),示例:"Images (*.png *.xpm .jpg);;Text files (.txt)" |
string getSaveFileName(string title, string directory, string filter)
功能:获取用户保存的全路径文件名
返回值: 结果,空串表示用户取消, 否则返回用户保存的文件路径文件名
参数 | 类型 | 含义 |
---|---|---|
title | string | 打开文件框的标题 |
directory | string | 打开对话框初始路径,不设初始值时请传空 |
filter | string | 文件类型过滤器(可为空),示例:"Images (*.png *.xpm .jpg);;Text files (.txt)" |
int getFileSize(const string &diskFileName)
功能:获取指定文件的大小
返回值: 文件长度
参数 | 类型 | 含义 |
---|---|---|
diskFileName | string | 指定的文件名 |
int deleteFile(const string &diskFileName);
功能:删除指定文件
返回值: CRVIDEOSDK_ERR_DEF类型的错误码,若无错误则返回CRVIDEOSDK_NOERR
参数 | 类型 | 含义 |
---|---|---|
diskFileName | 指定的文件名 |
string sendCmd(string targetUserId, string data)
功能:发送小块数据
返回值:发送者的用户ID
参数 | 类型 | 含义 |
---|---|---|
targetUserId | string | 目标用户ID |
data | string | 发送的数据(最大64KB) |
一次性发送不会有进度通知,发送结果事件sendCmdRlst,sendCmd不能被cancelSend
string sendBuffer(string targetUserId, string data)
功能:发送大块数据(分块发送)
返回值: 发送者的用户ID
参数 | 类型 | 含义 |
---|---|---|
targetUserId | string | 目标用户ID |
data | string | 发送的数据(最大100MB) |
进度通知事件sendProgress,发送结果事件sendBufferRlst,取消发送cancelSend
string sendFile(string targetUserId, string fileName)
功能:发送文件(分块发送 )
返回值: 发送者的用户ID
参数 | 类型 | 含义 |
---|---|---|
targetUserId | string | 目标用户ID |
fileName | string | 需要发送的文件名 |
进度通知事件sendProgress,发送结果事件sendFileRlst,取消发送cancelSend)
void cancelSend(string taskID)
功能: 取消数据发送
返回值:无
参数 | 类型 | 含义 |
---|---|---|
taskID | string | 任务ID |
取消数据发送 操作完成则回调cancelSendRlst
void initQueueDat(string cookie)
功能: 初始化队列
返回值:无
参数 | 类型 | 含义 |
---|---|---|
cookie | string | 详细介绍见关键词 |
操作完成回调initQueueDatRslt,队列初始化成功后才可获取队列队列相关信息
void refreshAllQueueStatus()
功能: 刷新所有队列状态
返回值:无
操作完成则触发queueStatusChanged(当前排队的队列,或服务的队列,sdk自动有状态变化回调)
string getAllQueueInfo()
功能: 查询队列
返回值:返回所有队列信息(QueueInfoObj)
int getQueueStatus(string queID)
功能: 获取队列状态
返回值:返回队列状态(QueStatusObj)
参数 | 类型 | 含义 |
---|---|---|
queID | string | 队列ID |
string getQueuingInfo()
功能: 获取我的排队信息
返回值:返回排队信息(QueuingInfoObj)
string getServingQueues()
功能: 获取我服务的所有队列
返回值:返回我服务的队列列表
string getSessionInfo()
功能: 获取我的会话信息
返回值: 返回会话信息SessionInfoObj
void startQueuing2(string queID,string usrExtDat,string cookie)
功能: 开始排队
返回值:无
参数 | 类型 | 含义 |
---|---|---|
queID | string | 队列ID |
usrExtDat | string | 用户排队携带的扩展数据, 座席在服务时可获得。 |
cookie | string | 详细介绍见关键词 |
带自定义扩展参数。 操作完成回调startQueuingRslt
void stopQueuing(string cookie)
功能: 停止排队
返回值:无
参数 | 类型 | 含义 |
---|---|---|
cookie | string | 详细介绍见关键词 |
操作完成回调stopQueuingRslt
void startService2(int queID, int priority, string cookie)
功能: 开始服务队列
返回值:无
参数 | 类型 | 含义 |
---|---|---|
queID | int | 队列ID |
priority | int | 坐席优先级 (缺省为0,取值为0~1000内整数。值越小优先级越高。0为最高优先级 )) |
cookie | string | 详细介绍见关键词 |
可以多次调用,开启对多个队列的服务。操作回调startServiceRslt 开启成功后: a. 如果没有开启免打挽,那么系统会自动分配客户:autoAssignUser; b. 如果开启免打挽,系统就不会分配客户,如需服务客户可调用:reqAssignUser 座席优先级描述:
- 座席优先级只在服务的队列内部有效;
- 客户优先分配给服务此队列优先级最高的,且空闲的座席;
- 优先级相同时,则分配给最先空闲的座席;
- 优先级高的座席变空闲时,不抢夺已分配的客户;
void stopService(string queID, string cookie)
功能: 停止服务队列
返回值:无
参数 | 类型 | 含义 |
---|---|---|
queID | string | queID 队列ID |
cookie | string | 详细介绍见关键词 |
操作完成回调stopServiceRslt
void reqAssignUser(string cookie)
功能: 请求分配一个客户
返回值:无
参数 | 类型 | 含义 |
---|---|---|
cookie | string | 详细介绍见关键词 |
回调函数:reqAssignUserRslt 当关闭免打扰时,系统将自动分配客户,无需调用此函数; 当开启免打扰时,系统不再自动分配客户,座席如需服务客户可使用此函数分配
void acceptAssignUser(string queID, string userID, string cookie)
- 功能: 接受分配的客户
参数 | 类型 | 含义 |
---|---|---|
queID | string | 队列ID |
userID | string | 队列中的用户ID |
cookie | string | 详细介绍见关键词 |
void rejectAssignUser(string queID, string userID, string cookie)
功能: 拒绝分配的客户
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
queID | string | 队列ID |
userID | string | 队列中的用户ID |
cookie | string | 详细介绍见关键词 |
void initQueueDatRslt(int sdkErr, const string &cookie)
- 功能:队列初始化操作结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkEr | int | 详细介绍见关键词 |
cookie | string | 详细介绍见关键词 |
void queueStatusChanged(const string &json queStatus)
- 功能:队列状态变化通知
- 参数:
参数 | 类型 | 含义 |
---|---|---|
queStatus | string | 队列状态 |
void queuingInfoChanged(const string &queuingInfo)
- 功能:排队信息变化通知
- 参数:
参数 | 类型 | 含义 |
---|---|---|
queuingInfo | string | 排队信息 |
void startQueuingRslt(int sdkErr, const string &cookie)
- 功能:开始排队操作结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkEr | int | 详细介绍见关键词 |
cookie | string | 详细介绍见关键词 |
void stopQueuingRslt(int sdkErr, const string &cookie)
- 功能:停止排队操作结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkEr | int | 详细介绍见关键词 |
cookie | string | 详细介绍见关键词 |
void startServiceRslt(int queID, int sdkErr, const string &cookie)
- 功能:开始服务队列操作结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
queID | int | 服务的队列ID |
sdkEr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void stopServiceRslt(int queID, int sdkErr, const string &cookie)
- 功能:停止服务队列操作结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
queID | int | 服务的队列ID |
sdkEr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void responseAssignUserRslt(int sdkErr, const string &cookie)
- 功能:响应分配客户操作结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkEr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void autoAssignUser(const string &jsonUsr)
- 功能:系统自动安排客户
- 参数:
参数 | 类型 | 含义 |
---|---|---|
jsonUsr | string | 队列用户信息。如果想停止系统的自动分配,请通setDNDStatus设置免打扰功能 |
void reqAssignUserRslt(int sdkErr, const string &jsonUsr, const string &cookie)
- 功能:请求分配客户操作结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkEr | int | 操作失败代码,定义见ERR_DEF |
jsonUsr | string | 队列用户信息 |
cookie | string | 详细介绍见关键词 |
void cancelAssignUser(int queID, const string &usrID)
- 功能:系统取消之前分配的的客户
- 参数:
参数 | 类型 | 含义 |
---|---|---|
queID | int | 服务的队列 |
userid | string | 用户id |
系统通过接口autoAssignUser给队列服务者自动推送客户(或队列服务者通过reqAssignUser请求分配客户),收到系统分配的客户后,如果队列服务者30秒之内不接受acceptAssignUser也不拒绝rejectAssignUser推送的客户,系统将通过本接口取消分配,然后将客户分配给其他空闲的服务者。
void call(string calledUserID, MeetInfoObj meetObj, string usrExtDat, string cookie)
功能: 发起呼叫
返回值:返回本次呼叫标识码(呼叫ID)
参数 | 类型 | 含义 |
---|---|---|
calledUserID | string | 被叫用户的账户ID |
meetObj | MeetInfoObj | 房间对象信息 |
usrExtDat | string | 自定义扩展参数 |
cookie | string | 详细介绍见关键词 |
操作成功则回调callSuccess,失败则回调callFail。 呼叫时,对方迟迟不响应,30秒后系统自动结束呼叫
void acceptCall(string callID, meetObj, string usrExtDat, string cookie)
- 功能: 接受对方发起的呼叫
参数 | 类型 | 含义 |
---|---|---|
callID | string | 呼叫ID |
meetObj | MeetInfoObj | 房间对象信息 |
usrExtDat | string | 自定义扩展参数 |
cookie | string | 详细介绍见关键词 |
开始进入视频房间。操作成功则回调acceptCallSuccess,失败则回调acceptCallFail
void rejectCall(string callID, string usrExtDat, string cookie)
功能: 拒绝对方发起的呼叫
返回值:无
参数 | 类型 | 含义 |
---|---|---|
callID | string | 呼叫ID |
usrExtDat | string | 自定义扩展参数 |
cookie | string | 详细介绍见关键词 |
操作成功则回调rejectCallSuccess,失败则回调rejectCallFail
void hungupCall(string callID, string usrExtDat, string cookie)
功能: 挂断呼叫
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
callID | string | 呼叫ID |
usrExtDat | string | 自定义扩展参数 |
cookie | string | 详细介绍见关键词 |
操作成功则回调hangupCallSuccess,失败则回调hangupCallFail
void callSuccess(const string& callID, const string &cookie)
- 功能:呼叫他人操作成功响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
callID | string | 呼叫全局标识 |
cookie | string | 详细介绍见关键词 |
void callFail(const string& callID, int sdkErr, const string &cookie)
- 功能:呼叫他人操作失败响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
callID | string | 呼叫全局标识 |
sdkEr | 操作失败代码,定义见ERR_DEF | |
cookie | string | 详细介绍见关键词 |
void acceptCallSuccess(const string& callID, const string &cookie)
- 功能:接受他人呼叫操作成功响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
callID | string | 呼叫全局标识 |
cookie | string | 详细介绍见关键词 |
void acceptCallFail(const string& callID, int sdkErr, const string &cookie)
- 功能:接受他人呼叫操作失败响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
callID | string | 呼叫全局标识 |
sdkEr | 操作失败代码,定义见ERR_DEF | |
cookie | string | 详细介绍见关键词 |
void rejectCallSuccess(const string& callID, const string &cookie)
- 功能:拒绝他人的呼叫成功响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
callID | string | 呼叫全局标识 |
cookie | string | 详细介绍见关键词 |
void rejectCallFail(const string& callID, int sdkErr, const string &cookie)
- 功能:拒绝他人的呼叫失败响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
callID | string | 呼叫全局标识 |
sdkEr | 操作失败代码,定义见ERR_DEF | |
cookie | string | 详细介绍见关键词 |
void hangupCallSuccess(const string& callID, const string &cookie)
- 功能:挂断他人的呼叫成功响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
callID | string | 呼叫全局标识 |
cookie | string | 详细介绍见关键词 |
void hangupCallFail(const string& callID, int sdkErr, const string &cookie)
- 功能:挂断呼叫操作失败响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
callID | string | 呼叫全局标识 |
sdkEr | 操作失败代码,定义见ERR_DEF | |
cookie | string | 详细介绍见关键词 |
void notifyCallIn(const string& callID, const string &meetObj, const string& callerID, const string& usrExtDat)
- 功能:SDK通知自己被呼叫
- 参数:
参数 | 类型 | 含义 |
---|---|---|
callID | string | 呼叫全局标识 |
meetObj | string | 房间对象 |
callerID | string | 呼叫人员的标识ID |
usrExtDat | string | 自定义扩展参数 |
void notifyCallAccepted(const string& callID, const string &meetObj, const string& usrExtDat)
- 功能:SDK通知自己视频呼叫被对方接受
- 参数:
参数 | 类型 | 含义 |
---|---|---|
callID | string | 呼叫全局标识 |
meetObj | string | 房间对象 |
usrExtDat | string | 自定义扩展参数 |
void notifyCallRejected(const string& callID, int reason, const string& usrExtDat)
- 功能:SDK通知自己呼叫被对方拒绝
- 参数:
参数 | 类型 | 含义 |
---|---|---|
callID | string | 呼叫全局标识 |
reason | int | 操作失败代码,定义见ERR_DEF |
usrExtDat | string | 自定义扩展参数 |
void notifyCallHungup(const string& callID, const string& usrExtDat)
- 功能:SDK通知自己呼叫被挂断
- 参数:
参数 | 类型 | 含义 |
---|---|---|
callID | string | 呼叫全局标识 |
usrExtDat | string | 自定义扩展参数 |
void sendCmdRlst(const string &sendId, int sdkErr, const string &cookie)
- 功能:发送小块数据时,SDK通知发送结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
taskID | string | 发送任务id |
sdkEr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void sendBufferRlst(const string &sendId, int sdkErr, const string &cookie)
- 功能:发送大块数据时,SDK通知发送结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
taskID | string | 发送任务id |
sdkEr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void sendFileRlst(const string &sendId, const string &fileName, int sdkErr, const string &cookie)
- 功能:发送文件时,SDK通知发送结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
taskID | string | 发送任务id |
fileName | int | 文件名 |
sdkEr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void sendProgress(const string &sendId, int sendedLen, int totalLen, const string &cookie)
- 功能:发送数据时,SDK通知发送进度
- 参数:
参数 | 类型 | 含义 |
---|---|---|
taskID | string | 发送任务id |
sendedLen | int | 已发送的数据长度 |
totalLen | int | 需要发送的总长度 |
cookie | string | 详细介绍见关键词 |
void cancelSendRlst(const string &sendId, int sdkErr, const string &cookie)
- 功能:取消发送响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
taskID | string | 发送任务id |
sdkEr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void notifyCmdData(const string &sourceUserId, const string &data)
- 功能:SDK通知收到小块数据
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sourceUserId | string | 数据来源的用户 |
data | string | 数据类型 |
void notifyBufferData(const string &sourceUserId, const string &data)
- 功能:SDK通知收到大块数据
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sourceUserId | string | 数据来源的用户 |
data | string | 数据类型 |
void notifyFileData(const string &sourceUserId, const string &tmpFile, const string &orgFileName)
- 功能:SDK通知收到文件数据(收到的文件生成在系统临时目录下,请尽快移走对应文件)
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sourceUserId | string | 数据来源的用户 |
tmpFile | string | 临时文件,不需要时,请移除或删除对应文件 |
orgFileName | string | 原始文件名 |
void notifyCancelSend(const string &sendId)
- 功能:SDK通知取消发送文件数据
- 参数:
参数 | 类型 | 含义 |
---|---|---|
taskID | string | 取消的任务id |
string invite(const string &inviteeUserID, const string &usrExtDat, const string &cookie)
功能:发送邀请
返回值:返回inviteID(每个邀请对应的唯一ID)
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteeUserID | string | 受邀者用户ID |
usrExtDat | string | 用户扩展数据 |
cookie | string | 详细介绍见关键词 |
string acceptInvite(const string &inviteID, const string &usrExtDat, const string &cookie)
- 功能:接受对方的邀请
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | string | 邀请ID |
usrExtDat | string | 用户扩展数据 |
cookie | string | 详细介绍见关键词 |
string rejectInvite(const string &inviteID, const string &usrExtDat, const string &cookie)
- 功能:拒绝对方的邀请
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | string | 邀请ID |
usrExtDat | string | 用户扩展数据 |
cookie | string | 详细介绍见关键词 |
string cancelInvite(const string &inviteID, const string &usrExtDat, const string &cookie)
- 功能:取消自己发送的邀请
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | string | 邀请ID |
usrExtDat | string | 用户扩展数据 |
cookie | string | 详细介绍见关键词 |
void inviteSuccess(const string &inviteID, const string &cookie)
- 功能:发送邀请成功
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | string | 邀请ID |
cookie | string | 详细介绍见关键词 |
void inviteFail(const string &inviteID, int sdkErr, const string &cookie)
- 功能:发送邀请失败
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | string | 邀请ID |
sdkErr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void cancelInviteSuccess(const string &inviteID, const string &cookie)
- 功能:取消自己发送的邀请成功
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | string | 邀请ID |
cookie | string | 详细介绍见关键词 |
void cancelInviteFail(const string &inviteID, int sdkErr, const string &cookie)
- 功能:取消自己发送的邀请失败
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | string | 邀请ID |
sdkErr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void acceptInviteSuccess(const string &inviteID, const string &cookie)
- 功能:接受对方的邀请成功
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | string | 邀请ID |
cookie | string | 详细介绍见关键词 |
void acceptInviteFail(const string &inviteID, int sdkErr, const string &cookie)
- 功能:接受对方的邀请失败
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | string | 邀请ID |
sdkErr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void rejectInviteSuccess(const string &inviteID, const string &cookie)
- 功能:拒绝对方的邀请成功
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | string | 邀请ID |
cookie | string | 详细介绍见关键词 |
void rejectInviteFail(const string &inviteID, int sdkErr, const string &cookie)
- 功能:拒绝对方的邀请失败
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | string | 邀请ID |
sdkErr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void notifyInviteIn(const string &inviteID, const string &inviterUsrID, const string &usrExtDat)
- 功能:通知有人邀请
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | string | 邀请ID |
inviterUsrID | string | 邀请者用户ID |
usrExtDat | string | 用户扩展数据 |
void notifyInviteAccepted(const string &inviteID, const string &usrExtDat)
- 功能:通知邀请被接受
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | string | 邀请ID |
usrExtDat | string | 用户扩展数据 |
void notifyInviteRejected(const string &inviteID, int reason, const string &usrExtDat)
- 功能:通知邀请被拒绝
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | string | 邀请ID |
reason | int | 邀请被拒绝原因,定义见ERR_DEF |
usrExtDat | string | 用户扩展数据 |
void notifyInviteCanceled(const string &inviteID, int reason, const string &usrExtDat)
- 功能:通知邀请被取消
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | string | 邀请ID |
reason | int | 邀请被取消原因,定义见ERR_DEF |
usrExtDat | string | 用户扩展数据 |
int getVideoWallMode2()
功能: 获取视频墙当前分屏模式
返回值:分屏模式(业务层自由定义)
void setVideoWallMode2(int videoWallMode)
功能: 设置视频墙分屏模式
返回值:无
参数 | 类型 | 含义 |
---|---|---|
videoWallMode | VideoLAYOUTMODE | 分屏模式 |
string getVideoCfg()
功能: 获取视频参数
返回值:获取视频参数,可参考(VideoCfgObj)
bool setVideoCfg(string cfg)
功能: 视频设置
返回值: 设置成功与否,true/false
参数 | 类型 | 含义 |
---|---|---|
cfg | VideoCfgObj | 设置参数 |
void inputCustomVideoDat2(int devID, const string& data, int timeStamp)
功能: 送入自定义摄像头数据
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
devID | devID | 摄像头ID |
string | data | 摄像头数据 |
int | timeStamp | 时间戳 |
int getVideoStatus(string userID)
功能: 视频状态
返回值:麦克风摄像头状态,可参考 CRVideo_VSTATUS
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户ID |
int getDefaultVideo(string userID)
功能: 获取默认摄像头ID
返回值:返回摄像头ID (int)
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户ID |
void setScaleType(int scaleType)
功能: 设置图像显示模式
返回值:无
参数 | 类型 | 含义 |
---|---|---|
scaleType | int | 0: 等比例缩放留空居中显示 1: 等比例缩放裁剪铺满显示; 2: 不等比例缩放铺满显示(可能导致图像拉伸) |
void setDefaultVideo(string userID, int videoID)
功能: 设置默认摄像头
返回值:无
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户ID |
videoID | int | 摄像头ID |
注意: 1、如果用户只有一个摄像头,可以不设置默认摄像头; 2、如果用户有多个摄像头,但是只想用其中一个,需要把这个设置为默认摄像头; 3、如果用户有多个摄像头,全都要用到,就不需要设置默认摄像头,打开摄像头时会全部打开; 4、如果用户有多个摄像头,想用到其中部分几个摄像头,不用设置默认摄像头,但是要先启用多摄像头,然后调用setLocVideoAttributes把不想用的禁用了,之后打开的时候就只打开没禁用的那几个;
int supportMaxScreenWidth
- 功能: 获取当前最大支持宽
int supportMaxScreenHeight
- 功能: 获取当前最大支持高
string getAllVideoInfo(const string &userID )
功能: 获取用户的所有摄像头信息
返回值:用户的所有摄像头信息列表,数据类型为:videoInfoObj的json格式(VideoInfosObj)
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户ID |
void setVideoDenoise(bool bDenoise)
功能: 开启或关闭摄像头降噪处理
返回值:无
参数 | 类型 | 含义 |
---|---|---|
bDenoise | bool | 取值true时,开启降噪处理 |
bool getVideoDenoise()
功能: 获取是否开启摄像头降噪
返回值:true:降噪已开启,false:降噪未开启
int createScreenCamDev(string camName,int monitor)
功能: 创建桌面摄像头(sdk最大支持5个)
返回值:<0, 失败, >=0, 为videoID(摄像头ID) (int)
参数 | 类型 | 含义 |
---|---|---|
camName | string | 摄像头名称 |
monitor | int | 显示器序号,与系统显示编号一致,-1代表主屏。(创建时对应monitorID不存在时将失败, 运行中monitorID对应的屏关闭时显示全黑,开启后恢复正常工作) |
添加成功后与本地摄像头处理一致;getAllVideoInfo接口可以识别摄像头类型。
bool updateScreenCamDev(int videoID, int monitor)
功能: 更新桌面摄像头
返回值:false失败, true成功 (bool)
参数 | 类型 | 含义 |
---|---|---|
videoID | int | 摄像头id |
monitor | int | 显示器序号,与系统显示编号一致,-1代表主屏。(monitorID不存在时将失败) |
void destroyScreenCamDev(int videoID)
功能: 消毁桌面摄像头
返回值:无
参数 | 类型 | 含义 |
---|---|---|
videoID | int | 摄像头id |
int createCustomVideoDev(string camName, video_FORMAT pixFmt, int width, int height,string extParams)
功能: 创建自定义摄像头(sdk最大支持5个)
返回值: <0 ,失败; >=0, 为videoID(摄像头ID) (int)
参数 | 类型 | 含义 |
---|---|---|
camName | string | 摄像头名称 |
pixFmt | video_FORMAT | 参见 video_FORMAT定义 |
width | int | 图像宽度 |
height | int | 图像高度 |
extParams | string | 扩展参数,没有为空 |
添加成功后与本地摄像头处理一致;getAllVideoInfo接口可以识别摄像头类型。
void destroyCustomVideoDev(int videoID)
功能: 消毁自定义摄像头
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
videoID | int | 摄像头id (createCustomVideoDev返回值) |
void inputCustomVideoDat(int videoID,string base64Dat, int timeStamp)
功能: 输入摄像头图像数据
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
videoID | int | 摄像头id |
base64Dat | string | 图像数据,base64编码。(请保证格式、和尺寸与摄像头匹配) |
timeStamp | int | 保留字段,请填0 |
string getWatchableVideos()
功能: 房间内可观看摄像头列表
返回值: 房间内可观看摄像头列表的json字符串,请参考 VideoIDObjs
只有摄像头打开才能被获取到,能获取到自已的和房间里其他人的
void openVideo(string userID)
功能: 打开用户的摄像头
返回值:无
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户的ID |
打开用户的摄像头,以便本地、远端显示视频图像
void closeVideo(string userID)
功能: 关闭用户的摄像头
返回值:无
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户ID |
int getEnableMutiVideo(string userID)
功能: 获取是否启用多摄像头
返回值:用户是否多摄像头(bool)
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户ID |
string getVideoImg()
功能: 摄像头图像数据
返回值:返回frame视频数据,可参考 VideoImgObj
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户ID |
videoID | int | 设备id |
bool showVideoAdvCfgDlg(int videoID, int hParenWnd)
功能: 调出摄像头驱动的高级配置(只对真实物理摄像头有效)
返回值:true/false
参数 | 类型 | 含义 |
---|---|---|
videoID | int | 摄像头id |
hParenWnd | int | 高级配置界面的父窗口, 没有特别需求传0即可 |
void setLocVideoAttributes(string videoID, string jsonAttributes)
功能: 视频设备私有参数配置
返回值:无
参数 | 类型 | 含义 |
---|---|---|
videoID | string | 本地摄像头id |
jsonAttributes | string | 详见VideoAttributesObj |
注:未设置的参数,使用全局参数
string getLocVideoAttributes(string videoID)
功能: 获取某个摄像头私有参数
返回值:私有参数, json格式,详见(VideoAttributesObj)
参数 | 类型 | 含义 |
---|---|---|
videoID | string | 本地摄像头id |
void setEnableMutiVideo(string userID,bool enable)
- 功能: 设置用户是否启用多摄像头
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户ID (当前只能配置自已) |
enable | bool | 1表示开启(将启用本地所有摄像头),0表示关闭(只启用默认摄像头,setDefaultVideo) |
如果只想开启某几个摄像头(不是所有), 那么需要:setEnableMutiVideo(myUserID, true), 然后调用setLocVideoAttributes将不需要的摄像头disable掉。
int addIPCam(string url)
功能: 添加网络摄像头(sdk最大支持5个)
返回值:sdkErr 操作结果码, 0代成功, 非0代表入会失败,定义见ERR_DEF
参数 | 类型 | 含义 |
---|---|---|
url | string | 网络摄像头url,支持协议:rtmp,rtsp |
添加成功后与本地摄像头处理一致;getAllVideoInfo接口可以识别哪些是网络摄像头。
void delIPCam(string url)
功能: 移除网络摄像头
返回值:无
参数 | 类型 | 含义 |
---|---|---|
url | string | 网络摄像头url,支持协议:rtmp,rtsp |
void videoDevChanged(const string &userID)
- 功能:SDK通知用户的视频设备有变化
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userID | string | 设备变化的用户ID |
void videoStatusChanged(const string &userID, int oldStatus, int newStatus)
- 功能:SDK通知打开本地视频状态变化
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userID | string | 房间中设备的所有者ID |
oldStatus | int | 旧状态 |
newStatus | int | 新状态 |
void switchtopage(int mainPage, string pageID)
功能: 功能切换
返回值:无
参数 | 类型 | 含义 |
---|---|---|
mainPage | int | 功能类型 |
pageID | string | 子页面标识(如创建白板时返回的boardID) |
void getcurrentmainpage()
功能: 获取当前主功能区
返回值:功能区(CRVideo_MAIN_PAGE_TYPE)
void getcurrentsubpage()
功能: 获取当前子页面
返回值:返回pageID(如:创建白板时返回的boardID)
string mainVideo
- 功能: 设置或者获取当前哪个用户为主视频
void setDNDStatus(int DNDStatus, string cookie)
功能: 设置免打扰状态
返回值:无
参数 | 类型 | 含义 |
---|---|---|
DNDStatus | int | 0代表关闭免打扰, 其它值代表开启免打扰,含义自由定义 |
cookie | string | 自定义数据 (在回调时,回传给调用者) |
操作成功则回调setDNDStatusSuccess,失败则回调setDNDStatusFailed
- 如果是使用到了SDK的队列功能,则入会后需调用此接口,设置自己的为免打扰状态,防止系统再次推送自己.
void getUserStatus(string cookie)
功能: 获取企业下所有用户在线状态
返回值:无
参数 | 类型 | 含义 |
---|---|---|
cookie | string | 自定义数据(在回调时,回传给调用者,不需要时传空字符串) |
操作成功则回调getUserStatusSuccess,失败则回调getUserStatusFail
void getOneUserStatus(string usrID, string cookie)
功能: 获取企业下指定用户的在线状态
返回值:无
参数 | 类型 | 含义 |
---|---|---|
usrID | string | 用户ID |
cookie | string | 自定义数据(在回调时,回传给调用者,不需要时传空字符串) |
操作成功则回调getUserStatusSuccess,失败则回调getUserStatusFail
void startUserStatusNotify(string cookie)
功能: 开启用户的状态推送
返回值:无
参数 | 类型 | 含义 |
---|---|---|
cookie | string | 自定义数据(在回调时,回传给调用者,不需要时传空字符串) |
回调函数: startUserStatusNotifyRslt 企业下所有用户状态有变化时包括呼叫房间状态、免打扰状态),都会收到通知开启后,用户量越大消息量越大,所以请按需开启在startUserStatusNotify前,应该先通过getUserStatus获取所有用户状态
void stopUserStatusNotify(string cookie)
功能: 关闭用户的状态推送
返回值:无
参数 | 类型 | 含义 |
---|---|---|
cookie | string | 自定义数据(在回调时,回传给调用者,不需要时传空字符串) |
回调函数: stopUserStatusNotifyRslt
void createMeeting2(string params, string cookie)
功能: 创建房间
返回值:无
参数 | 类型 | 含义 |
---|---|---|
params | string | 保留参数 |
操作成功则回调createMeetingSuccess,失败则回调createMeetingFail
void destroyMeeting(string meetID, string cookie)
功能: 销毁房间
返回值:无
参数 | 类型 | 含义 |
---|---|---|
meetID | int | 房间id |
cookie | string | 详细介绍见关键词 |
void getMeetings(string cookie)
void getMeetings2(string json,string cookie)
功能: 获取房间列表
返回值:无
参数 | 类型 | 含义 |
---|---|---|
json | string | 获取视频房间列表的参数,json结构体,请参见GetMeetingsParamObj,可不传入参数,使用getMeetings,默认获取全部 |
cookie | string | 详细介绍见关键词 |
响应事件getMeetingsSuccess,房间被他人结束的回调事件getMeetingsFail
void setNickNameRsp(int err, const string &userid, const string &newname)
- 功能:SDK通知设置房间成员昵称的结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkErr | int | 操作结果码, 0代表设置成功, 非0代表设置失败 |
userid | string | 当前的昵称 |
newname | string | 新的昵称 |
void notifyNickNameChanged(const string &userid, const string &oldname, const string &newname)
- 功能:SDK通知某用户改变了昵称(改昵称的用户自身不会接收到此通知)
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userid | string | 用户id |
oldname | string | 当前的昵称 |
newname | string | 新的昵称 |
void notifyVideoWallMode2(int model)
- 功能:SDK通知视频分屏模式切换
- 参数:
参数 | 类型 | 含义 |
---|---|---|
model | int | 分屏模式 |
void notifyMainVideoChanged()
- 功能:SDK通知主视频更改
void notifySwitchToPage(int mainPage, const string &subPageID)
- 功能:SDK通知功能切换
- 参数:
参数 | 类型 | 含义 |
---|---|---|
mainPage | int | 功能类型 |
pageID | string | 子页面标识 |
void defVideoChanged(const string &userID, int videoID)
- 功能:SDK通知用户的视频默认设备有变化
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户id,, 命名规则 详见关键词 |
videoID | int | 默认设备id |
void netStateChanged(int level)
- 功能:SDK通知我的网络变化
- 参数:
参数 | 类型 | 含义 |
---|---|---|
level | int | 网络状况等级(0~10,10分为最佳网络) |
void mousePressed(int btnType, int x, int y, int keyboardModifiers)
- 功能:SDK通知鼠标按下
- 参数:
参数 | 类型 | 含义 |
---|---|---|
btnType | int | 按键类型 |
x | int | 鼠标位置x |
y | int | 鼠标位置y |
keyboardModifiers | int | 辅助键值 |
void mouseReleased(int btnType, int x, int y, int keyboardModifiers)
- 功能:SDK通知鼠标释放
- 参数:
参数 | 类型 | 含义 |
---|---|---|
btnType | int | 按键类型 |
x | int | 鼠标位置x |
y | int | 鼠标位置y |
keyboardModifiers | int | 辅助键值 |
void mouseDoubleClicked(int btnType, int x, int y, int keyboardModifiers)
- 功能:SDK通知鼠标双击
- 参数:
参数 | 类型 | 含义 |
---|---|---|
btnType | int | 按键类型 |
x | int | 鼠标位置x |
y | int | 鼠标位置y |
keyboardModifiers | int | 辅助键值 |
void toolButtonClicked(int id)
- 功能:SDK通知鼠标点击到文件条目索引
- 参数:
参数 | 类型 | 含义 |
---|---|---|
id | int | 文件条目索引 |
void enterMeeting(string meetID, string pswd, string userID, string nickName, string reserve)
功能: 进入房间
返回值:无
参数 | 类型 | 含义 |
---|---|---|
meetID | int | 房间ID |
pswd | string | md5处理后的,本次房间中的密码(系统自动生成,在呼叫回调中取得) |
userID | string | 用户id, 命名规则 详见关键词 |
nickName | string | 昵称 |
reserve | string | 保留字段,填空 |
双方开始进入房间 操作完成则回调enterMeetingRslt
void exitMeeting()
功能: 离开房间
返回值:无
void kickout(string userId)
功能:剔出用户
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userId | string | 用户id |
void enterMeetingRslt(int sdkErr)
- 功能:进入房间完成响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkErr | int | 操作失败代码,定义见ERR_DEF |
void stopMeetingRslt(int sdkErr)
- 功能:通知停止会议结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkErr | int | 操作失败代码,定义见ERR_DEF |
void userEnterMeeting(const string &userID)
- 功能某用户进入了房间
void userLeftMeeting(const string &userID)
- 功能:某用户离开了房间
void meetingDropped()
- 功能:SDK通知从房间里掉线了
void meetingStopped()
- 功能:房间已被结束
他人离开房间的回调事件userLeftMeeting
void stopMeeting(int meetID, string reserve)
功能: 停止会议
返回值:无
参数 | 类型 | 含义 |
---|---|---|
meetID | int | 房间id |
reserve | string | 保留字段, 填空 |
回调函数stopMeetingRslt,调用此接口停止会议时,其他会话用户会收到meetingStopped
void setDNDStatusSuccess(const string &cookie)
- 功能:客户端设置免打扰状态操作成功响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
cookie | string | 详细介绍见关键词 |
void setDNDStatusFail(int sdkErr, const string &cookie)
- 功能:客户端设置免打扰状态操作失败响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkErr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void getUserStatusSuccess(const string &usersStatus, const string &cookie)
- 功能:客获取所有用户在线状态成功响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
usersStatus | string | 用户在线状态信息列表,userID:用户id,userStatus:用户的在线状态(0离线 ;1在线空闲 ;2在线忙碌;3在线房间中),DNDType:用户免打扰状态(0代表关闭免打扰,其它值代表开启免打扰) |
cookie | string | 详细介绍见关键词 |
void getUserStatusFail(int sdkErr, const string &cookie)
- 功能:获取所有用户在线状态失败响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkErr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void startUserStatusNotifyRslt(int sdkErr, const string &cookie)
- 功能:启动用户状态推送响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkErr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void stopUserStatusNotifyRslt(int sdkErr, const string &cookie)
- 功能:结束用户状态推送响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkErr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void notifyUserStatus(const string &userStatus)
- 功能:某个用户状态变化通知
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userStatus | string | 用户的在线状态(0离线 ;1在线空闲 ;2在线忙碌;3在线房间中) |
void lineOff(int sdkErr)
- 功能:SDK通知自己掉线
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkErr | int | 操作失败代码,定义见ERR_DEF |
void notifyTokenWillExpire()
- 功能:通知Token即将失效,有效时间剩余30s左右(可调用updateToken更新Token)
void createMeetingSuccess(const string &meetObj, const string &cookie)
- 功能:创建房间成功响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
meetObj | string | 房间对象 |
cookie | string | 详细介绍见关键词 |
void createMeetingFailed(int sdkErr, const string &cookie)
- 功能:创建房间失败响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkErr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void destroyMeetingRslt(int sdkErr, const string &cookie)
- 功能:销毁房间响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkErr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void getMeetingsSuccess(const string &jsonMeetings, const string &cookie)
- 功能:获取房间列表成功响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
jsonMeetings | string | 房间列表信息 |
cookie | string | 详细介绍见关键词 |
void getMeetingsFail(int sdkErr, const string &cookie)
- 功能:获取房间列表失败响应
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkEr | int | 操作失败代码,定义见ERR_DEF |
cookie | string | 详细介绍见关键词 |
void setMediaCfg(string jsonCfg)
功能: 设置音频配置
返回值:无
参数 | 类型 | 含义 |
---|---|---|
jsonCfg | string | 详见VideoCfgObj说明 |
string getMediacfg()
功能: 获取音频参数
返回值:json格式的音频参数,详见VideoCfgObj说明
void setSpeakerMute()
功能: 设置扬声器静音
返回值:无
int speakerMute
- 功能: 设置或者获取扬声器静音状态
string getAudioMicNames()
功能: 麦克风设备列表
返回值:返回麦克风设备字符串列表(Array)
string getAudioSpkNames()
功能: 扬声器设备列表
返回值:扬声器设备列表(Array)
void setAudioCfg(string cfg)
功能: 麦克风设置
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
cfg | AudioCfgObj | 设置参数 |
string getAudioCfg()
功能: 获取麦克风设置
返回值:cfg对象(AudioCfgObj)
int getMicEnergy(string userID)
功能: 麦克风声音大小
返回值:返回音量(0~10)(int)
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户的ID |
void openMic(string userID)
功能: 打开麦克风
返回值:无
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户的ID |
打开自已的麦克风时,先会进入到AOPENING状态,等服务器处理后才会进入AOPEN状态,此时说话才能被采集到
void closeMic(string userID)
功能: 关闭麦克风
返回值:无
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户的ID |
关麦操作是立即生效的,本地会立即停止采集
int getAudioStatus(string userID)
功能: 麦克风状态
返回值:返回麦克风状态(CRVideo_ASTATUS)
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户的ID |
双方开始进入本次视频会话。操作完成则回调enterMeetingRslt
int micVolume
- 功能: 设置或者获取麦克风音量
int speakerVolume
- 功能: 获取或者设置扬声器音量,扬声器音量(0~255)
bool setSpeakerVolume(int level)
功能: 设置扬声器音量
返回值:设置成功则返回true,否则返回false(bool)
参数 | 类型 | 含义 |
---|---|---|
level | int | 音量等级( 取值范围:0~255) |
void setAllAudioClose()
功能: 关闭所有人麦克风
返回值:无
void audioDevChanged()
功能: 麦克风设备变化
功能:SDK通知本地音频设备有变化
void audioStatusChanged(const string &userID, int oldStatus, int newStatus)
- 功能:SDK通知打开本地音频状态变化
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userID | string | 会话中设备的所有者ID |
oldStatus | int | 音频旧状态,参考麦克风状态ASTATUS |
newStatus | int | 音频新状态,参考麦克风状态ASTATUS |
void micEnergyUpdate(const string& userID, int oldLevel, int newLevel)
- 功能:SDK通知用户的说话声音强度更新
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户ID |
oldLevel | int | 原来的说话声音强度 |
newLevel | int | 现在的说话声音强度 |
void openVideoDevRslt(int videoID, bool isSucceed)
- 功能:SDK通知打开摄像头通知
- 参数:
参数 | 类型 | 含义 |
---|---|---|
videoID | int | 摄像头索引 |
isSucceed | int | 是否成功 |
int startPlayMedia(string filename, int locPlay, int bPauseWhenFinished)
功能: 开始播放影音
返回值:返回值 整形数值,1:正常,0:失败(int)
参数 | 类型 | 含义 |
---|---|---|
filename | string | 媒体文件名(本地全路径文件名,或网络流媒体,支持的协议有:http, rtmp, rtsp) |
locPlay | int | 是否仅仅本地播放(1:本地播放,0:房间内播放) |
bPauseWhenFinished | int | 是否播放完毕自动暂停在最后一帧 |
int mediaVolume
- 功能: 设置或者获取影音音量
void pausePlayMedia(bool bPause)
功能: 暂停或恢复播放影音
返回值:无
参数 | 类型 | 含义 |
---|---|---|
bPause | bool | ture为暂停,false为恢复 |
void stopPlayMedia()
功能: 停止播放影音
返回值:无
void setMediaplaypos(int pos)
功能: 设置播放进度
返回值:无
参数 | 类型 | 含义 |
---|---|---|
pos | int | 设置播放位置,单位:毫秒 |
string getmediainfo(string userID)
功能: 影音播放信息
返回值:影音文件信息(MediaInfoObj)
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户id,详见UID |
string getmediaimg(string userID)
功能: 获取影音图像数据
返回值:帧信息(videoImgObj)
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户id |
int startGetAudioPCM(int aSide, int getType, string jsonParam)
功能: 开始获取语音pcm数据
返回值:返回值 整形数值,1:正常,0:失败(int)
参数 | 类型 | 含义 |
---|---|---|
aSide | int | 声道类型 0:麦克风,1:扬声器 |
getType | int | 获取方式 0:回调方式,1:保存为文件 |
jsonParam | string | 当getType=0 表示回调方式,jsonParam可配置回调的数据大小(320-32000),如: {"EachSize":320};当getType=1 表示保存为文件,jsonParam可配置文件名,如: { "FileName" : "e:\test.pcm" } |
void stopGetAudioPCM(aSide)
功能: 停止获取语音pcm数据
返回值:无
参数 | 类型 | 含义 |
---|---|---|
aSide | int | 声道类型 0:麦克风,1:扬声器 |
void notifyMediaOpened(long totalTime, const int w, const int h)
- 功能SDK通知影音文件打开
- 参数:
参数 | 类型 | 含义 |
---|---|---|
totalTime | long | 影音时长(秒) |
w | int | 宽度 |
h | int | 高度 |
void notifyMediaStart(const string &userid)
- 功能:SDK通知影音开始播放
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userid | string | 操作者的用户id |
void notifyMediaStop(const string &userid, int reason)
- 功能:SDK通知影音播放停止
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userid | string | 操作者的用户id |
reason | int | 播放停止原因,详见MEDIA_STOP_REASON |
void notifyMediaPause(const string &userid, int bPause)
- 功能:SDK通知影音播放是否暂停
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userid | string | 操作者的用户id |
pause | int | 是否暂停 1暂停 0播放 |
void notifyPlayPosSetted(int setPos)
- 功能:SDK通知播放进度已设置完成
- 参数:
参数 | 类型 | 含义 |
---|---|---|
setPos | int | 播放进度 |
void notifyAudioPCMDat(int aSide, const string &base64PcmDat)
- 功能:SDK通知语音PCM数据
- 参数:
参数 | 类型 | 含义 |
---|---|---|
aSide | int | 声道类型 |
base64PcmDat | string | PCM数据(base64格式) |
void notifyAllAudioClose(const string &userID)
- 功能:通知关闭音频
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userID | string | 用户ID |
影音共享UI显示组件
void disableToolBar(int bDisable)
功能:设置工具条是否可用
返回值:无
int savePicToFile(const string &pathFileName)
功能:保存当前图像帧到文件
返回值:保存是否成功
- 参数:
参数 | 类型 | 含义 |
---|---|---|
pathFileName | string | 本地绝对路径文件名(支持格式:bmp, png, gif, jpg, jpeg) |
void setDblClickFullScreen(int value)
功能:设置是否支持双击全屏,默认不支持双击全屏
返回值:无
string savePicToBase64(string format)
功能:保存播放影音画面到图片文件
返回值:保存文件路径
string savePicToBase64(string pathFileName)
功能:保存播放影音画面到图片文件
返回值:0成功,非0失败 (int)
- 参数:
参数 | 类型 | 含义 |
---|---|---|
pathFileName | string | 本地绝对路径文件名(支持格式:bmp, png, gif, jpg, jpeg) |
void setToolBarUIElementVisible(int UIElement, bool isVisible)
功能:显示隐藏播放工具条上的界面元素
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
UIElement | int | 界面元素ToolBarUI |
isVisible | bool | 是否可见 |
void setToolBarSize(int size)
功能:设置影音工具条的大小
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
size | int | 尺寸大小 |
void disableChangePlayPos(int bDisable)
功能:设置禁止调整播放位置
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
bDisable | int | 是否禁止 |
void setFullScreen(bool bFullScreen)
功能:设置全屏
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
bFullScreen | bool | true :全屏 |
void getFullScreen()
功能:获取全屏状态
返回值:无表示该控件当前是否全屏,true 表示全屏
屏幕共享UI显示组件
void clear()
- 清空缓存的图像void ctrlOpen(bool)
功能:开启控制模式
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
value | bool | true: 开启, false:不开启 |
void disableFloatToolbar(bool bDisabled)
功能: 是否禁止出现浮动工具
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
bDisabled | bool | true:禁止出现, false:允许出现(缺省值) |
bool isCursorInUI()
功能:鼠标是否在屏幕共享显示控件上
返回值:鼠标是否在控件上,true- 在控件上; false - 不在控件上 (bool)
string getCursorPosInRemote()
功能:鼠标在本地的屏幕共享UI控件上时,鼠标位置映射到远端的屏幕上的坐标
返回值:映射到远端的屏幕上的坐标。数据格式:json格式,如:{"x"=1,"y"=1}
int getPicWidth()
功能:获取远端屏幕的实际宽度
返回值:远端屏幕的实际宽度(int)
int getPicHeight()
功能:获取远端屏幕的实际高度
返回值:远端屏幕的实际高度(int)
void enableMarked(bool value)
功能:开启标注模式
返回值:无
参数:
参数 | 类型 | 含义 |
---|---|---|
value | bool | 0: 不开启, 1:开启 |
int isPicEmpty()
功能: 检查图像是否为空
返回值:int
参数:
参数 | 类型 | 含义 |
---|---|---|
value | int | 0: 有图像, 1:无图像 |
bool savePic(string pathFileName)
功能:拍照
返回值:0:成功; 非0:保存遇到的错误码(bool)
参数:
参数 | 类型 | 含义 |
---|---|---|
pathFileName | string | 本地绝对路径文件名(支持格式:bmp, png, gif, jpg, jpeg) |
void setPenStyle(intRgba color, int penType))
功能:设置标注画笔样式
返回值:无
参数:
参数 | 类型 | 含义 |
---|---|---|
intRgba | int | 颜色,排列方式bgr(8:8:8) |
penType | int | 画笔类型(1:铅笔, 2:水笔) |
void setFullScreen(bool bFullScreen)
功能:设置全屏
返回值:无
参数:
参数 | 类型 | 含义 |
---|---|---|
bFullScreen | bool | true :全屏 |
bool getFullScreen()
功能:获取全屏
返回值:表示该控件当前是否全屏,true 表示全屏
void setDblClickFullScreen(bool bVal)
功能:配置是否允许双击全屏
返回值:无
参数:无
参数 | 类型 | 含义 |
---|---|---|
bVal | bool | true:允许(缺省值), false:不允许 |
bool getDblClickFullScreen()
功能:获取是否允许双击全屏
返回值:表示该控件是否允许双击全屏,true 允许, false:不允许
成员视频UI显示组件
void clear()
- 功能:清理当前图像
string getUserID()
功能:获取当前的userID
返回值:当前的userID
string getVideoID()
功能:获取当前显示的用户的视频设备
返回值:视频ID (string)
bool visibleNickName
- 功能: 设置或者获取当前是否显示昵称
int gisPicEmpty
- 功能: 当前是否有图像
int keepAspectRatio
功能: 是否保持宽高比例
返回值:bool
bool dblClickFullScreen
- 功能: 设置或者获取是否双击全屏
void setMaskPic(string base64PNG, bool bScaleToFitVideoUI)
功能:在视频窗口上显示一个遮罩图片
返回值:无
参数:
参数 | 类型 | 含义 |
---|---|---|
base64PNG | string | base64格式的png图像数据 |
bScaleToFitVideoUI | bool | true:铺满视频窗口,false:居中显示 |
void setMaskPic2(string pngDat, bool bScaleToFitVideoUI)
功能:在视频窗口上显示一个遮罩图片
返回值:无
参数:
参数 | 类型 | 含义 |
---|---|---|
pngDat | string | png图像原始数据 |
bScaleToFitVideoUI | bool | true:铺满视频窗口,false:居中显示 |
bool isPicEmpty()
功能: 检查图像是否为空
返回值:图像是否为空
int getPicFrameTime()
功能: 获取图像时间戳
返回值:当前图像数据对应的时间戳(int)
bool dblClickFullScreen(bool value)
- 功能: 设置是否支持双击全屏,默认不支持双击全屏
int savePic(string pathFileName)
功能: 拍照
返回值:0:成功; 非0:保存遇到的错误码 (bool)
参数:
参数 | 类型 | 含义 |
---|---|---|
pathFileName | string | 本地绝对路径文件名(支持格式:bmp, png, gif, jpg, jpeg) |
bool enableMarked
- 功能: 可被标记
int ctrlOpen
- 功能: 可被控制开关
string savePicToBase64(string format)
功能: 拍照
返回值:Base64为图片数据字符串,不成功则为空 (string)
参数:
参数 | 类型 | 含义 |
---|---|---|
format | string | 图片格式,支持bmp, png, gif, jpg, jpeg |
void setMaskPic(string base64PNG, bool scaleToFitVideoUI)
功能: 在视频窗口上显示一个遮罩图片
返回值:无
参数:
参数 | 类型 | 含义 |
---|---|---|
base64PNG | string | base64格式的png图像数据 |
scaleToFitVideoUI | bool | true:铺满视频窗口,false:居中显示 |
void setToolbarHeight(int height)
功能: 配置工具条高度
返回值:无
参数:
参数 | 类型 | 含义 |
---|---|---|
height | int | 工具条高度 |
void setToolButton(int id, const string &iconFileName, const string &toolTip)
功能: 设置显示文件条目控件属性,若iconFileName所指向的文件不存在,则在界面上删除该条目
返回值:无
参数:
参数 | 类型 | 含义 |
---|---|---|
id | int | 条目索引 |
iconFileName | string | 按钮显示的文件名 |
toolTip | string | 文件说明 |
void lockNickNameText(const string &lockNickNameText)
功能: 锁定昵称显示内容,设为空代表取消锁定
返回值:无
参数:
参数 | 类型 | 含义 |
---|---|---|
lockNickNameText | string | 昵称显示内容 |
void setSavePicRect(int x, int y, int w, int h)
功能: 设置拍照区域
返回值:无
参数:
参数 | 类型 | 含义 |
---|---|---|
x | int | 相对于VideoUI控件的左上角位置(水平方向) |
y | int | 相对于VideoUI控件的左上角位置(垂直方向) |
w | int | 拍照的图像大小(宽) |
h | int | 拍照的图像大小(高) |
status | int | 第3方呼叫状态码:0-振铃; 1-接通 ;2-拒绝; 3-未应答 ;4-挂断 |
注意:此设配置对以下所有保存接口有效, 当x,y,w,h均为0时,代表保存完整图像。
int getPicWidth()
功能: 获取图像宽
返回值:图像宽
int getPicHeight()
功能:获取图像高
返回值:图像高
void setFullScreen(bool bFullScreen)
功能:设置全屏
返回值:无
bool getFullScreen()
功能: 获取全屏
返回值: 表示该控件当前是否全屏,true 表示全屏
void setVideo(string userID, int videoID)
功能: 设置显示的目标用户视频
返回值:无
参数:
参数 | 类型 | 含义 |
---|---|---|
userID | string | 目标用户ID |
videoID | int | 用户的指定视频设备(-1,代表用户的默认视频设备) |
void setVideo2(string userID, int videoID, int qualityLv)
功能: 设置显示目标用户的第2档视频
返回值:无
参数:
参数 | 类型 | 含义 |
---|---|---|
userID | string | 目标用户ID |
videoID | int | 用户的指定视频设备(-1,代表用户的默认视频设备) |
qualityLv | int | 视频档位(1:默认档位,2:对应quality2,如果2未开启时将显示1档的视频流) |
从房间内可观看摄像头列表中获取userID和videoID
开启一个摄像头多档视频流,请参见setLocVideoAttributes
注意:配置后就会建立视频通道并占用带宽。 如果不再观看时,应设为空:setVideo("", -1)。
int getQualityLv()
功能: 获取当前显示的视频档位
返回值: 视频档位
参数:无
白板显示UI显示组件
CloudroomBoardUI 白板显示组件,是由视频房间组件内相关接口的封装而成,如果此组件不满足需求,可以使用视频房间组件内相关的接口自行实现。
string getBoardIDs()
功能: 获取当前房间内的所有白板ID
返回值: 白板的ID,字符串数组 (string[])
string getBoardInfo(boardID)
功能:获取指定白板的信息
返回值: 白板信息,json格式,详见BoardObj说明
string getCurBoardID()
功能:获取当前显示的白板
返回值: 白板的ID (string)
int getCurPageNo()
功能: 获取当前白板的当前页
返回值: 页序号(0为第一页) (int)
void setCurBoard(string boardID, int pageNo)
功能: 设置当前白板
返回值: 无
参数:
参数 | 类型 | 含义 |
---|---|---|
boardID | string | 白板的ID |
pageNo | int | 白板的页序号,0为第一页 |
void undo()
功能: 撤消我的最后一个标注
返回值: 无
void redo()
功能: 恢复我的最后一次撤消
返回值: 无
void clear()
功能: 清空当前白板所有标注(清空操作不能再恢复)
返回值: 无
bool isScaledContents()
功能: 获取白板当前的缩放模式,缩放模式下内容将被缩小或放大以填充有效区域,非缩放模式下图像将按原始尺寸显示并可能出现滚动条
返回值: bool
void setScaledContents(bool bScaled)
功能: 设置白板的缩放模式
返回值: 无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
bScaled | bool | 是否启用缩放模式 |
void setColor(int argb)
功能: 设置画笔颜色
返回值: 无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
argb | int | 画笔颜色为argb8888 |
int getColor()
功能: 获取画笔颜色
返回值: int
void setLineWidth(int width)
功能: 设置画笔粗细
返回值: 无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
width | int | 线条的宽度 |
int getLineWidth()
功能: 获取当前画笔颜色
返回值: 线条的宽度 (int)
void setReadOnly(bool bReadOnly)
功能: 设置白板本地只读(本地禁止标注,其他端不受影响)
返回值: 无
参数:
参数 | 类型 | 含义 |
---|---|---|
bReadOnly | bool | 是否只读 |
bool isReadOnly()
功能: 获取白板本地只读配置
返回值: 是否只读 (bool), true - 白板本地只读
void startMgr()
功能: 启动http文档上传下载功能
返回值:无
void stopMgr()
功能: 停止http文档上传下载功能
返回值:无
string getAllTransferInfos()
功能: 获取本地所有上传、下载文件信息
返回值:详见 HttpFileInfoObjs
HttpFileInfoObj getTransferInfo(string filePathName)
功能: 获取本地指定文件的上传、下载文件信息
返回值:详见 HttpFileInfoObj
参数:
参数 | 类型 | 含义 |
---|---|---|
filePathName | string | 本地路径文件名 |
void startTransferFile(HttpReqInfo fileinfo)
功能: 开始下载/上传文件
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
fileinfo | string | 详见HttpFileInfoObj |
void cancelFileTransfer(string fileName)
功能: 取消传输
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
fileName | string | 本地路径文件名 |
注意:取消时,只是停止了传输任务,不清理记录及断点文件。
void rmTransferInfo(string fileName,int bRemoveLocFile)
功能: 删除传输记录及相关文件
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
fileName | string | 文件名 |
bRemoveLocFile | int | 是否移除本地文件,为1时,那么上传的源始文件、下载的临时文件或结果文件都将被移除。 |
注意: 此接口将文件从管理器中移除(getAllTransferInfos将不再返回相关信息),如果bRemoveLocFile为1时, 那么上传的源始文件、下载的临时文件或结果文件都将被移除。
void fileStateChanged(const string &fileName, HTTP_TRANSFER_STAT state)
- 功能: 通知用户文件状态更改
- 参数:
参数 | 类型 | 含义 |
---|---|---|
fileName | string | 文件名 |
state | int | 详细介绍见HTTP_TRANSFER_STAT |
void fileProgress(conststring &fileName, int finisedSize, int totalSize)
- 功能: 通知用户文件的传输进度
- 参数:
参数 | 类型 | 含义 |
---|---|---|
fileName | string | 文件名 |
totalSize | int | 文件总大小 |
void fileFinished(const string &fileName, int rslt)
- 功能: 通知用户文件传输结束
- 参数:
参数 | 类型 | 含义 |
---|---|---|
fileName | string | 文件名 |
rslt | int | 传输结果,详见CRVideo_HTTP_TRANSFER_RESULT |
void fileHttpRspHeader(const string &fileName, const string &rspHeader)
- 功能: 通知http响应消息的header数据
- 参数:
参数 | 类型 | 含义 |
---|---|---|
fileName | string | 文件名 |
rspHeader | string | http响应头 |
void fileHttpRspContent(const string &filename, const string &content)
- 功能: 通知上传完成后,http的响应内容
- 参数:
参数 | 类型 | 含义 |
---|---|---|
fileName | string | 文件名 |
rspContent | string | http上传完成后的响应内容 |
int tryReadFile(string diskPathFileName)
功能: 尝试读取文件
返回值:尝试结果,定义见ERR_DEF
- 参数:
参数 | 类型 | 含义 |
---|---|---|
diskPathFileName | string | 本地路径文件名 |
string readFileAsBase64(string diskPathFileName)
功能: 读取文件
返回值: 以base64编码读取到的内容,并返回编码后的内容
- 参数:
参数 | 类型 | 含义 |
---|---|---|
diskPathFileName | string | 本地路径文件名 |
SAFEARRAY(BYTE) readFileData(const string &diskFileName, int offset, int dataLength);
功能: 读取文件
返回值: 返回读取到的文件内容
- 参数:
参数 | 类型 | 含义 |
---|---|---|
diskPathFileName | string | 本地路径文件名 |
offset | int | 相对于文件开头的偏移量 |
dataLength | int | 读取长度 |
int writeBase64ToFile(string diskPathFileName, string base64Dat)
功能: 创建或重写文件(如果目录不存在,则创建目录)
返回值: 结果,定义见ERR_DEF
- 参数:
参数 | 类型 | 含义 |
---|---|---|
diskPathFileName | string | 本地路径文件名 |
base64Dat | string | base64编码格式的文件数据 |
int moveFile(string srcDiskFileName, string dstDiskFileName)
功能: 移动文件
返回值: 结果,定义见ERR_DEF
- 参数:
参数 | 类型 | 含义 |
---|---|---|
srcDiskFileName | string | 本地源文件 |
dstDiskFileName | string | 本地目标文件 |
注意:目标文件如果已存在,将按失败处理,不会覆盖;
string getOpenFileName(string title, string directory, string filter)
功能: 获取用户打开的全路径文件名
返回值: 结果,空串表示用户取消, 否则返回用户选择的文件路径文件名
- 参数:
参数 | 类型 | 含义 |
---|---|---|
title | string | 打开文件框的标题 |
directory | string | 打开对话框初始路径,不设初始值时请传空 |
filter | string | 文件类型过滤器(可为空),示例:"Images (*.png *.xpm .jpg);;Text files (.txt)" |
string getSaveFileName(string title, string directory, string filter)
功能: 获取用户保存的全路径文件名
返回值: 结果,空串表示用户取消, 否则返回用户保存的文件路径文件名
- 参数:
参数 | 类型 | 含义 |
---|---|---|
title | string | 打开文件框的标题 |
directory | string | 打开对话框初始路径,不设初始值时请传空 |
filter | string | 文件类型过滤器(可为空),示例:"Images (*.png *.xpm .jpg);;Text files (.txt)" |
void removeFromRecordMgr(string filename)
功能: 删除本地的录制文件
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
filename | string | 文件名 |
上传中的文件会被取消上传,已上传完成的服务器文件不受影响
int addFileToRecordMgr(string fileName, string filePath)
功能: 添加本地文件到录制文件管理中
返回值: -1:本地文件不存在,0:成功,1:文件已经被添加过
- 参数:
参数 | 类型 | 含义 |
---|---|---|
filename | string | 文件名,不含路径 |
filePath | string | 文件路径,不含文件名 |
第三方录制文件调用此接口后可进行本地回放和上传到视频服务器上,和自己录制的文件一样可以正常在线播放和下载
string getWriteablePathInIEProtectedMode()
功能: 获取ie的保护模式下可读写的路径(获取到的为InternetCache目录,在系统重启或InternetCache目录清理时,此目录下的内容将会丢失)
返回值:ie的保护模式下可读写的
bool isIEProtectedMode()
功能: 检查插件是否运行在ie的保护模式下
返回值:true - ie保护模式下; false - 非ie或非保护模式{bool}
void startScreenMark()
功能: 开始屏幕共享标注
返回值: 无
void stopScreenMark()
功能: 停止屏幕共享标注
返回值: 无
void setMarkText(string videoFilePathName,int msecond, string markText)
功能: 添加视频打点信息
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
videoFilePathName | string | 视频文件路径名 |
msecond | int | 视频播放的位置(毫秒) |
markText | string | 打点信息 |
调用此接口会生成一个和视频文件同名且有.json后缀的打点文本文件
void removeMarkText(string videoFilePathName,msecond)
功能: 移除视频打点信息
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
videoFilePathName | string | 视频文件路径名 |
msecond | int | 视频播放的位置(毫秒) |
string getVideoMarkFile(string videoFilePathName)
功能: 获取视频文件对应的打点文件
返回值:打点文件的路径文件名
- 参数:
参数 | 类型 | 含义 |
---|---|---|
videoFilePathName | string | 视频文件路径名 |
string getAllMarks(string videoFilePathName)
功能:获取所有的视频打点信息
返回值:打点信息集合字符串,json格式
- 参数:
参数 | 类型 | 含义 |
---|---|---|
videoFilePathName | string | 视频文件路径名 |
string getRecordFileInfo(string fileName)
功能:获取录制文件信息
返回值:文件信息,详见RecordFileInfoObj
- 参数:
参数 | 类型 | 含义 |
---|---|---|
fileName | string | 文件名, 不含路径 |
void getMeetingAllAttrs(string cookie)
功能:获取房间所有属性
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
cookie | string | 可为空字符串。详细介绍见关键词 |
void getMeetingAttrs( string keys, string cookie)
功能:获取房间部份属性
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
keys | string | 需要查询的房间属性key,json格式,如:["key1", "key2"] |
cookie | string | 可为空字符串。详细介绍见关键词 |
void setMeetingAttrs( string attrs, string options, string cookie)
功能:重置房间属性集
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
attrs | string | 房间属性集,json格式,如:{"key1":"value1", "key2":"value2"} |
options | string | 操作选项,json格式参见MeetingAttrOptions |
cookie | string | 可为空字符串。详细介绍见关键词 |
void addOrUpdateMeetingAttrs( string attrs, string options, string cookie)
功能:增加或者更新房间属性
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
attrs | string | 房间属性集,json格式,如:{"key1":"value1", "key2":"value2"} |
options | string | 操作选项,json格式参见MeetingAttrOptions |
cookie | string | 可为空字符串。详细介绍见关键词 |
void delMeetingAttrs( string keys, string options, string cookie)
功能:删除房间属性
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
keys | string | 需要删除的房间属性key,json格式,如["key1","key2"] |
options | string | 操作选项,json格式参见MeetingAttrOptions |
cookie | string | 可为空字符串。详细介绍见关键词 |
keys示例:
void clearMeetingAttrs(string options, string cookie)
功能:清除房间所有属性
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
options | string | 操作选项,json格式参见MeetingAttrOptions |
cookie | string | 可为空字符串。详细介绍见关键词 |
void getUserAttrs(string uids, string keys, string cookie)
功能:获取用户属性
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
uids | string | 目标用户id列表,一次最多包含50个用户,不允许为空,json格式, 如:["uid1","uid2"] |
keys | string | 指定要获取的属性key列表(空串代表获取全部),json格式, 如:["uid1","uid2"] |
cookie | string | 可为空字符串。详细介绍见关键词 |
void getUserAttrs(string uids, string keys, string cookie)
功能:获取指定用户的指定属性
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
uids | string | 目标用户id列表,一次最多包含50个用户,json格式, 如:["uid1","uid2"] |
keys | string | 将要获取的用户属性key列表,json格式,如:["key1","key2"] |
cookie | string | 可为空字符串。详细介绍见关键词 |
void setUserAttrs(string uid, string attrs, string options, string cookie)
功能:重置用户属性
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
uid | string | 目标用户id |
attrs | string | 用户属性集, json格式,如:{"key1":"value1", "key2":"value2"} |
options | string | 操作选项,json格式参见MeetingAttrOptions |
cookie | string | 可为空字符串。详细介绍见关键词 |
void addOrUpdateUserAttrs(string uid, string attrs, string options, string cookie)
功能:增加或更新用户属性
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
uid | string | 目标用户id |
attrs | string | 用户属性集, json格式,如:{"key1":"value1", "key2":"value2"} |
options | string | 操作选项,json格式参见MeetingAttrOptions |
cookie | string | 可为空字符串。详细介绍见关键词 |
void delUserAttrs(string uid, string keys, string options, string cookie)
功能:删除用户的特定属性
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
uid | string | 目标用户id |
keys | string | 需要删除的用户属性key列表,json格式,如:["key1","key2"] |
options | string | 操作选项,json格式参见MeetingAttrOptions |
cookie | string | 可为空字符串。详细介绍见关键词 |
void clearAllUserAttrs(string options, string cookie)
功能:清除所有用户的所有属性
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
options | string | 操作选项,json格式参见MeetingAttrOptions |
cookie | string | 可为空字符串。详细介绍见关键词 |
void clearUserAttrs(string uid, string options, string cookie)
功能:清除特定用户的所有属性
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
uid | string | 目标用户id |
options | string | 操作选项,json格式参见MeetingAttrOptions |
cookie | string | 可为空字符串。详细介绍见关键词 |
void sendMeetingCustomMsg(string msg, string cookie)
功能:发送房间内自定义广播消息
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
msg | string | 用户自定义消息 |
cookie | string | 可为空字符串。详细介绍见关键词 |
void getMeetingAllAttrsSuccess(string attrs, string cookie)
- 功能:成功获取到房间属性
- 参数:
参数 | 类型 | 含义 |
---|---|---|
attrs | string | 房间属性集,json结构体请参见MeetingAttrObjs |
cookie | string | 可为空字符串。详细介绍见关键词 |
void getMeetingAllAttrsFail(int err, string cookie)
- 功能:获取房间属性失败
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | int | 错误码(错误码为CRVIDEOSDK_NOERR表示没有错误) |
cookie | string | 可为空字符串。详细介绍见关键词 |
void setMeetingAttrsRslt(int err, string cookie)
- 功能:设置用户属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | int | 错误码(错误码为CRVIDEOSDK_NOERR表示没有错误) |
cookie | string | 可为空字符串。详细介绍见关键词 |
void addOrUpdateMeetingAttrsRslt(int err, string cookie)
- 功能:增加或更新房间属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | int | 错误码(错误码为CRVIDEOSDK_NOERR表示没有错误) |
cookie | string | 可为空字符串。详细介绍见关键词 |
void delMeetingAttrsRslt(int err, string cookie)
- 功能:删除房间属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | int | 错误码(错误码为CRVIDEOSDK_NOERR表示没有错误) |
cookie | string | 可为空字符串。详细介绍见关键词 |
void clearMeetingAttrsRslt(int err, string cookie)
- 功能:清除房间属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | int | 错误码(错误码为CRVIDEOSDK_NOERR表示没有错误) |
cookie | string | 可为空字符串。详细介绍见关键词 |
void getUserAttrsSuccess(string attrsMap, string cookie)
- 功能:获取房间内用户属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
attrsMap | string | 房间属性,json结构体请参见UsrMeetingAttrObjs |
cookie | string | 可为空字符串。详细介绍见关键词 |
void getUserAttrsFail(int err, string cookie)
- 功能:获取房间内用户属性失败
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | int | 错误码(错误码为CRVIDEOSDK_NOERR表示没有错误) |
cookie | string | 可为空字符串。详细介绍见关键词 |
void setUserAttrsRslt(int err, string cookie)
- 功能:设置用户属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | int | 错误码(错误码为CRVIDEOSDK_NOERR表示没有错误) |
cookie | string | 可为空字符串。详细介绍见关键词 |
void addOrUpdateUserAttrsRslt(int err, string cookie)
- 功能:增加或者更新用户属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | int | 错误码(错误码为CRVIDEOSDK_NOERR表示没有错误) |
cookie | string | 可为空字符串。详细介绍见关键词 |
void delUserAttrsRslt(int err, string cookie)
- 功能:删除特定用户属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | int | 错误码(错误码为CRVIDEOSDK_NOERR表示没有错误) |
cookie | string | 可为空字符串。详细介绍见关键词 |
void clearAllUserAttrsRslt(int err, string cookie)
- 功能:删除所有用户属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | int | 错误码(错误码为CRVIDEOSDK_NOERR表示没有错误) |
cookie | string | 可为空字符串。详细介绍见关键词 |
void clearUserAttrsRslt(int err, string cookie)
- 功能:删除特定用户属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | int | 错误码(错误码为CRVIDEOSDK_NOERR表示没有错误) |
cookie | string | 可为空字符串。详细介绍见关键词 |
void notifyMeetingAttrsChanged(string adds, string updates, string delKeys)
- 功能:通知房间属性发生改变
- 参数:
参数 | 类型 | 含义 |
---|---|---|
adds | string | 增加房间属性集,json结构体请参见MeetingAttrObjs |
updates | string | 变化的房间属性集,json结构体请参见MeetingAttrObjs |
delKeys | string | 被删除的房间属性列表,json格式,如:["key1", "key2"] |
void notifyUserAttrsChanged(string uid, string adds, string updates, string delKeys)
- 功能:通知用户属性发生改变
- 参数:
参数 | 类型 | 含义 |
---|---|---|
uid | string | 变化的用户id |
adds | string | 增加的用户属性集,json结构体请参见MeetingAttrObjs |
updates | string | 变化的用户属性集,json结构体请参见MeetingAttrObjs |
delKeys | string | 被删除的用户属性列表,json格式,如:["key1", "key2"] |
void sendMeetingCustomMsgRslt( int err, string cookie)
- 功能:通知发送房间内自定义广播消息结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | int | 错误码(错误码为CRVIDEOSDK_NOERR表示没有错误) |
cookie | string | 可为空字符串。详细介绍见关键词 |
void notifyMeetingCustomMsg(string uid, string jsonDat)
- 功能:通知收到房间内自定义广播消息
- 参数:
参数 | 类型 | 含义 |
---|---|---|
uid | string | 房间内广播消息的发送者的用户id |
jsonDat | string | 广播内容 |
← 房间和成员自定义属性 常量定义→