API参考
CloudroomVideoSDK接口详情
CloudroomVideoSDK 是基础控件,负责整个SDK的初始化和反初始化操作。整个程序的生命过程中只能有一个实例
String GetCloudroomVideoSDKVer()
-
功能: 获取SDK版本号
-
返回值: SDK版本号
CRVIDEOSDK_ERR_DEF init(Context context, SdkInitDat dat)
-
功能: SDK初始化
-
返回值: CRVIDEOSDK_NOERR为成功操作,其他详见定义CRVIDEOSDK_ERR_DEF
参数 | 类型 | 含义 |
---|---|---|
context | Context | 程序上下文,不可为空 |
dat | SdkInitDat | SDK配置、临时文件存放位置,不可为空 |
void uninit()
-
功能: SDK反初始化
-
返回值: 无
String serverAddr()
-
功能: 获取服务器地址
-
返回值: 服务器地址(如:www.cloudroom.com)或多个服务器地址串(如:www.cloudroom.com:8080;183.60.47.52:8080;)
void setServerAddr(String serverList)
-
功能: 设置服务器地址
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
serverList | String | 服务器地址(如:www.cloudroom.com)或多个服务器地址串(如:www.cloudroom.com:8080;183.60.47.52:8080;) |
CloudroomVideoMgr接口详情
管理组件,实现登录、呼叫、房间创建销毁、透明传输等功能。 整个程序的生命过程中只能有一个实例。
void registerCallBack(CloudroomVideoMgrCallback callBack)
-
功能: 注册监听回调
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callBack | CloudroomVideoMgrCallback | 回调对象 |
void unregisterCallBack(CloudroomVideoMgrCallback callBack)
-
功能: 反注册监听回调
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callBack | CloudroomVideoMgrCallback | 反注册的回调对象 |
void login(String appID, String appSecret, String userID, String userAuthCode, String cookie)
void loginByAppID(String appID, String appSecret, String userID, String userAuthCode, String cookie)
-
功能: 密码登录
-
返回值: 无
登录成功则触发回调loginSuccess , 登录失败则触发回调loginFail
参数 | 类型 | 含义 |
---|---|---|
appID | String | appID用于区分不同的项目,每个项目都有属于自己的唯一的appID,不同appID的项目完全独立,无法相互通信。appID请联系云屋销售获取,并开通相关套餐和功能权限。 |
appSecret | String | appID对应的密码(md5加密传给sdk),可登录云屋管理后台修改 |
userID | String | 用户ID,长度不能大于128。和云屋系统无关,业务方自由填写,保证唯一性即可(同一appID下,具有唯一性即可) |
userAuthCode | String | 默认填空。只有开启第三方认证才需要填写。(开启第三方认证时,云屋SDK服务器将连接提前配好的业务方服务器进行实时验证。) |
cookie | String | 可为空字符串。详细介绍见关键词 |
- 补充说明:
- 登陆成功则回调loginSuccess
- 登陆失败则回调loginFail
void loginByToken(String token, String userID, String userAuthCode, String cookie)
- 功能: Token登录
- 返回值:无
参数 | 类型 | 含义 |
---|---|---|
token | String | Token鉴权码 |
userID | String | 用户ID。和云屋系统无关,业务方自由填写,保证唯一性即可(同一appID下,具有唯一性即可) |
userAuthCode | String | 默认填空。只有开启第三方认证才需要填写。(开启第三方认证时,云屋SDK服务器将连接提前配好的业务方服务器进行实时验证。) |
cookie | String | 可为空字符串。详细介绍见关键词 |
- 补充说明:
- 登陆成功则回调loginSuccess
- 登陆失败则回调loginFail
- 在token有效期只有30秒时,sdk将发出notifyTokenWillExpire通知,集成方应尽快通过updateToken更新新的token延长有限时间。
void updateToken(String token)
- 功能: 更新Token(在Token即将失效的时候更新Token延长有限时间)
参数 | 类型 | 含义 |
---|---|---|
token | String | Token鉴权码 |
int getUserAuthErrCode()
-
功能: 获取第三方鉴权失败码(只有在登录失败原因为:CRVIDEOSDK_CUSTOMAUTH_FAILED时有效)
-
返回值: 第三方返回的失败码
String getUserAuthErrDesc()
-
功能: 获取第三方鉴权失败原因描述(只有在登录失败原因为:CRVIDEOSDK_CUSTOMAUTH_FAILED时有效)
-
返回值: 第三方返回的描述串
void logout()
-
功能: 注销
-
返回值: 无
退出程序时,必须注销本次登录,然后再进行SDK反初始化操作
void setDNDStatus(int DNDStatus, String cookie)
- 功能: 设置免打扰状态, 如果使用到了SDK的队列功能,则进入房间后需调用此接口,设置自己的为免打扰状态,防止系统再次推送自己
- 返回值: 无
设置免打扰状态成功则触发回调setDNDStatusSuccess , 设置免打扰状态失败则触发回调setDNDStatusFail
参数 | 类型 | 含义 |
---|---|---|
DNDStatus | int | 0代表关闭免打扰, 其它值代表开启免打扰,含义自由定义 |
cookie | String | 自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void getUserStatus(String userID, String cookie)
-
功能: 获取企业下指定用户的在线状态
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userID | String | 具体用户的账户ID |
cookie | String | 自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void getUserStatus(String cookie)
-
功能: 将获取企业下所有用户在线状态(包括呼叫房间状态、免打扰状态)
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
cookie | String | 自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void startUserStatusNotify(String cookie)
- 功能: 开启用户的状态推送 。开启后,企业下所有用户状态有变化时(包括呼叫房间状态、免打扰状态),都会收到通知。开启后,用户量越大消息量越大,所以请按需开启。
- 返回值: 无
参数 | 类型 | 含义 |
---|---|---|
cookie | String | 自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void stopUserStatusNotify(String cookie)
-
功能: 关闭用户的状态推送
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
cookie | String | 自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void createMeeting(String cookie)
-
功能: 创建视频房间
-
返回值: 无
创建房间成功则触发回调createMeetingSuccess,创建房间失败则触发createMeetingFail
参数 | 类型 | 含义 |
---|---|---|
cookie | String | 自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void destroyMeeting(int meetID, String cookie)
-
功能: 销毁视频房间
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
meetID | int | 房间号) |
cookie | String | 自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
String call(String calledUserID, MeetInfo meetInfo, String userExtDat, String cookie)
-
功能: 发起呼叫,邀请用户参加视频会话, 呼叫时,对方迟迟不响应,30秒后系统自动结束呼叫
-
返回值: 本次呼叫标识码(呼叫ID)
发起呼叫成功则触发回调callSuccess,发起呼叫失败则触发callFail
参数 | 类型 | 含义 |
---|---|---|
calledUserID | String | 被叫用户的账户ID |
meetInfo | MeetInfo | 房间信息,空时代表无房间信息,应由被叫创建或提供房间信息 |
usrExtDat | String | 自定义扩展参数 |
cookie | String | 自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void acceptCall(String callID, MeetInfo meetInfo, String usrExtDat, String cookie)
-
功能: 接受对方发起的视频请求,开始进入视频会话
-
返回值: 无
接受对方发起的视频请求成功则触发回调acceptCallSuccess,接受对方发起的视频请求失败则触发acceptCallFail
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫标识码 |
meetInfo | MeetInfo | 房间信息 |
usrExtDat | String | 自定义扩展参数 |
cookie | String | 自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void rejectCall(String callID, String usrExtDat, String cookie)
-
功能: 拒绝对方的视频请求
-
返回值: 无
拒绝对方发起的视频请求成功则触发回调rejectCallSuccess,拒绝对方发起的视频请求失败则触发rejectCallFail
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫标识码 |
usrExtDat | String | 自定义扩展参数 |
cookie | String | 自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void hangupCall(String callID, String usrExtDat, String cookie)
-
功能: 挂断正在进行的视频呼叫或视频通话
-
返回值: 无
挂断视频成功则触发回调hangupCallSuccess,挂断视频失败则触发hangupCallFail
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫标识码 |
usrExtDat | String | 自定义扩展参数 |
cookie | String | 自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
String callMoreParty(String calledUserID, MeetInfo meetInfo, String usrExtDat, String cookie)
- 功能:发起多方呼叫(或呼转)
呼叫结果参见callMorePartyRslt;
呼转实现思路: A、B通话已建立(假设callID为IdAB),B想由C来服务A,B callMoreParty C(假设callID为IdBC), 在C接受进入通话后,A便可挂断IdAB通话并离开房间。
-
返回值:String 呼叫ID
-
参数:
参数 | 类型 | 含义 |
---|---|---|
calledUserID | String | 被叫用户ID |
meetObj | MeetInfo | 房间信息 |
usrExtDat | String | 扩展信息 |
cookie | String | 上下文参数,详细介绍参见关键词 |
void cancelCallMoreParty(String inviteID, String usrExtDat, String cookie)
- 功能:取消多方呼叫
取消结果参见cancelCallMorePartyRslt;
-
返回值:String 呼叫ID
-
参数:
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫ID |
usrExtDat | String | 扩展信息 |
cookie | String | 上下文参数,详细介绍参见关键词 |
String sendCmd(String targetUserId, String data)
-
功能: 发送小块数据(50K以内),此接口不能被cancelSend, 一次性发送,不会有进度通知
-
返回值: 分配的任务ID
回调函数sendCmdRlst
参数 | 类型 | 含义 |
---|---|---|
targetUserId | String | 目标用户ID |
data | String | 发送的数据,base64编码 |
String sendBuffer(String targetUserId, String data)
-
功能: 发送大块数据 ,分块发送,进度通知事件sendProgress, 调用cancelSend 取消发送
-
返回值: 分配的任务ID
回调函数sendBufferRlst
参数 | 类型 | 含义 |
---|---|---|
targetUserId | String | 目标用户ID |
data | String | 发送的数据,base64编码 |
String sendFile(String targetUserId, String fileName)
-
功能: 发送文件 ,分块发送,进度通知事件sendProgress,调用cancelSend取消发送
-
返回值: 分配的任务ID
回调函数sendFileRlst
参数 | 类型 | 含义 |
---|---|---|
targetUserId | String | 目标用户ID |
fileName | String | 需要发送的文件名 |
void cancelSend(String taskID)
-
功能: 取消数据发送
-
返回值: 无
回调函数cancelSendRlst
参数 | 类型 | 含义 |
---|---|---|
taskID | String | 任务ID |
void setMarkText(String videoFilePathName, int timestamp, String markText)
-
功能: 添加视频打点信息
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
videoFilePathName | NSString | 视频文件全路径 |
timestamp | int | 时间戳 |
markText | NSString | 打点信息 |
void removeMarkText(String videoFilePathName, int timestamp)
-
功能: 移除视频打点信息
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
videoFilePathName | NSString | 视频文件全路径 |
timestamp | int | 时间戳 |
String getAllMarks(String videoFilePathName)
-
功能: 获取所有打点信息
-
返回值: 打点信息
参数 | 类型 | 含义 |
---|---|---|
videoFilePathName | NSString | 视频文件全路径 |
String getVideoMarkFile(String videoFilePathName)
-
功能: 获取打点文件的绝对文件路径名
-
返回值: 打点文件的绝对文件路径名
参数 | 类型 | 含义 |
---|---|---|
videoFilePathName | NSString | 视频文件全路径 |
CloudroomVideoMgr通知回调接口详情
void loginSuccess(String usrID, String cookie)
-
功能: 登录成功回调
-
返回值:无
参数 | 类型 | 含义 |
---|---|---|
usrID | String | 用户ID |
cookie | String | 详细介绍见关键词 |
void loginFail(CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 登录失败回调,登录出错,可以弹出错误提示,或调用登录接口再次重试登录
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果代码 |
cookie | String | 详细介绍见关键词 |
如果启用了第三方鉴权,并在鉴权失败时(sdkErr为CRVIDEOSDK_CUSTOMAUTH_FAILED),可以通过getUserAuthErrCode、getUserAuthErrDesc获取详细原因。
void setDNDStatusSuccess(String cookie)
-
功能: 客户端设置免打扰状态操作成功响应
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
cookie | String | 自定义用户数据 |
void setDNDStatusFail(CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 客户端设置免打扰状态操作失败响应
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果代码 |
cookie | String | 自定义用户数据 |
void getUserStatusRslt(CRVIDEOSDK_ERR_DEF sdkErr, ArrayList<UserStatus> userStatus, String cookie)
-
功能: 获取企业内所有用户在线状态响应
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果代码 |
usersStatus | ArrayList<UserStatus> | 用户在线状态信息列表 |
cookie | String | 自定义用户数据 |
void startStatusPushRslt(CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 启动用户状态推送响应
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果代码 |
cookie | String | 自定义用户数据 |
void stopStatusPushRslt(CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 结束用户状态推送响应
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果代码 |
cookie | String | 自定义用户数据 |
void notifyUserStatus(UserStatus userStatus)
-
功能: 某个用户状态变化通知
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userStatus | UserStatus | 单个用户在线状态信息 |
void lineOff(CRVIDEOSDK_ERR_DEF sdkErr)
-
功能: SDK通知自己掉线
-
返回值: 无
void notifyTokenWillExpire()
-
功能: 通知Token即将失效,有效时间剩余30s左右(可调用updateToken更新Token)
-
返回值: 无
void createMeetingSuccess(MeetInfo meetInfo, String cookie)
-
功能: 创建房间成功响应
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
meetInfo | MeetInfo | 房间信息 |
cookie | String | 自定义用户数据 |
void createMeetingFail(CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 创建房间成功响应
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sdkErr | CRVIDEOSDK_ERR_DEF | 操作失败代码 |
cookie | String | 自定义用户数据 |
void destroyMeetingRslt(CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 结束房间响应
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果代码,成功为CRVIDEOSDK_NOERR |
cookie | String | 自定义用户数据 |
void callSuccess(String callID, String cookie)
-
功能: 呼叫他人操作成功响应
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫全局标识 |
cookie | String | 自定义用户数据 |
void callFail(String callID, CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 呼叫他人操作失败响应
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫全局标识 |
sdkErr | CRVIDEOSDK_ERR_DEF | 操作失败代码 |
cookie | String | 自定义用户数据 |
void acceptCallSuccess(String callID, String cookie)
-
功能: 接受他人呼叫操作成功响应
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫全局标识 |
cookie | String | 自定义用户数据 |
void acceptCallFail(String callID, CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 接受他人呼叫操作失败响应
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫全局标识 |
sdkErr | CRVIDEOSDK_ERR_DEF | 操作失败代码 |
cookie | String | 自定义用户数据 |
void rejectCallSuccess(String callID, String cookie)
-
功能: 拒绝他人的呼叫成功响应
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫全局标识 |
cookie | String | 自定义用户数据 |
void rejectCallFail(String callID, CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 拒绝他人的呼叫失败响应
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫全局标识 |
sdkErr | CRVIDEOSDK_ERR_DEF | 操作失败代码 |
cookie | String | 自定义用户数据 |
void hangupCallSuccess(String callID, String cookie)
-
功能: 挂断呼叫操作成功响应
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫全局标识 |
cookie | String | 自定义用户数据 |
void hangupCallFail(String callID, CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 拒绝他人呼叫操作失败响应
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫全局标识 |
sdkErr | CRVIDEOSDK_ERR_DEF | 操作失败代码 |
cookie | String | 自定义用户数据 |
void notifyCallIn(String callID, MeetInfo meetInfo, String callerID, String usrExtDat)
-
功能: 服务端通知被邀请
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫全局标识 |
meetInfo | MeetInfo | 房间信息,空时代表无房间信息,应由被叫创建或提供房间信息 |
callerID | String | 呼叫人员的标识ID |
usrExtDat | String | 自定义扩展参数 |
void notifyCallAccepted(String callID, MeetInfo meetInfo, String usrExtDat)
-
功能: 服务端通知呼叫邀请被接受回调
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫全局标识 |
meetInfo | MeetInfo | 房间信息,空时代表无房间信息,应由被叫创建或提供房间信息 |
usrExtDat | String | 自定义扩展参数 |
void notifyCallRejected(String callID, CRVIDEOSDK_ERR_DEF reason, String usrExtDat)
-
功能: 服务端通知呼叫邀请被拒绝回调
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫全局标识 |
reason | CRVIDEOSDK_ERR_DEF | 呼叫被对方拒绝的原因代码 |
usrExtDat | String | 自定义扩展参数 |
void notifyCallhangup(String callID, String usrExtDat)
-
功能: SDK通知呼叫被挂断
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫全局标识 |
usrExtDat | String | 自定义扩展参数 |
callMorePartyRslt(String callID, CRVIDEOSDK_ERR_DEF sdkErr, String cookie);
-
功能:发起多方呼叫结果
-
返回值:无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫ID, callMoreParty的返回值 |
sdkErr | CRVIDEOSDK_ERR_DEF | CRVIDEOSDK_NOERR代表成功,其它值代表失败原因,如: CRVIDEOSDK_ERR_BUSY:对方通话中或免打扰 CRVIDEOSDK_ERR_OFFLINE:对方不在线 |
cookie | String | 请求接口传入的cookie参数 |
cancelCallMorePartyRslt(String callID, CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能:取消多方呼叫结果
-
返回值:无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫ID, callMoreParty的返回值 |
sdkErr | CRVIDEOSDK_ERR_DEF | CRVIDEOSDK_NOERR代表成功,其它值代表失败原因 |
cookie | String | 请求接口传入的cookie参数 |
notifyCallMorePartyStatus(String callID, INVITE_STATUS status)
-
功能:通知多方呼叫状态
-
返回值:无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
callID | String | 呼叫ID, callMoreParty的返回值 |
status | INVITE_STATUS | 多方呼叫状态 |
void sendCmdRlst(String taskID, CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 发送数据时,SDK通知发送结果
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
taskID | String | 发送任务id |
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果代码 |
cookie | String | 自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void sendBufferRlst(String taskID, CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 发送数据时,SDK通知发送结果
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
taskID | String | 发送任务id |
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果代码 |
cookie | String | 自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void sendFileRlst(String taskID, String fileName, CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 发送数据时,SDK通知发送结果
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
taskID | String | 发送任务id |
fileName | String | 文件名 |
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果代码 |
cookie | String | 自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void sendProgress(String taskID, int sendedLen, int totalLen, String cookie)
-
功能: 发送数据时,SDK通知发送进度
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
taskID | String | 发送任务id |
sendedLen | int | 已发送的数据长度 |
totalLen | int | 需要发送的总长度 |
cookie | String | 自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void cancelSendRlst(String taskID, CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 取消发送操作响应
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
taskID | String | 发送任务id |
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果代码 |
cookie | String | 自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void notifyCmdData(String sourceUserId, String data)
-
功能: SDK通知收到小块数据
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sourceUserId | String | 数据来源 |
data | String | 数组数据 |
void notifyBufferData(String sourceUserId, String data)
-
功能: SDK通知收到大块数据
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sourceUserId | String | 数据来源 |
data | String | 数组数据 |
void notifyFileData(String sourceUserId, String tmpFile, String orgFileName)
-
功能: SDK通知收到文件数据
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sourceUserId | String | 数据来源 |
tmpFile | String | 临时文件,不需要时,请移除或删除对应文件 |
orgFileName | String | 源始文件名 |
void notifyCancelSend(String taskID)
-
功能: 通知发来的数据/文件被取消
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
taskID | 发送的任务ID | 数据来源 |
String invite(String invitedUserID, String usrExtDat, String cookie)
-
功能:发送邀请
-
返回值:返回inviteID(每个邀请对应的唯一ID)
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteeUserID | String | 受邀者用户ID |
usrExtDat | String | 用户扩展数据 |
cookie | String | 详细介绍见关键词 |
void acceptInvite(String inviteID, String usrExtDat, String cookie)
- 功能:接受对方的邀请
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | String | 邀请ID |
usrExtDat | String | 用户扩展数据 |
cookie | String | 详细介绍见关键词 |
void rejectInvite(String inviteID, String usrExtDat, String cookie)
- 功能:拒绝对方的邀请
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | String | 邀请ID |
usrExtDat | String | 用户扩展数据 |
cookie | String | 详细介绍见关键词 |
void cancelInvite(String inviteID, String usrExtDat, String cookie)
- 功能:取消自己发送的邀请
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | String | 邀请ID |
usrExtDat | String | 用户扩展数据 |
cookie | String | 详细介绍见关键词 |
void inviteSuccess(String inviteID, String cookie)
- 功能:发送邀请成功
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | String | 邀请ID |
cookie | String | 详细介绍见关键词 |
void inviteFail(String inviteID, CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
- 功能:发送邀请失败
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | String | 邀请ID |
sdkErr | CRVIDEOSDK_ERR_DEF | 操作失败代码,定义见ERR_DEF |
cookie | String | 详细介绍见关键词 |
void cancelInviteSuccess(String inviteID, String cookie)
- 功能:取消自己发送的邀请成功
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | String | 邀请ID |
cookie | String | 详细介绍见关键词 |
void cancelInviteFail(String inviteID, CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
- 功能:取消自己发送的邀请失败
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | String | 邀请ID |
sdkErr | CRVIDEOSDK_ERR_DEF | 操作失败代码,定义见ERR_DEF |
cookie | String | 详细介绍见关键词 |
void acceptInviteSuccess(String inviteID, String cookie)
- 功能:接受对方的邀请成功
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | String | 邀请ID |
cookie | String | 详细介绍见关键词 |
void acceptInviteFail(String inviteID, CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
- 功能:接受对方的邀请失败
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | String | 邀请ID |
sdkErr | CRVIDEOSDK_ERR_DEF | 操作失败代码,定义见ERR_DEF |
cookie | String | 详细介绍见关键词 |
void rejectInviteSuccess(String inviteID, String cookie)
- 功能:拒绝对方的邀请成功
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | String | 邀请ID |
cookie | String | 详细介绍见关键词 |
void rejectInviteFail(String inviteID, CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
- 功能:拒绝对方的邀请失败
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | String | 邀请ID |
sdkErr | CRVIDEOSDK_ERR_DEF | 操作失败代码,定义见ERR_DEF |
cookie | String | 详细介绍见关键词 |
void notifyInviteIn(String inviteID, String inviterUsrID, String usrExtDat)
- 功能:通知有人邀请
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | String | 邀请ID |
inviterUsrID | String | 邀请者用户ID |
usrExtDat | String | 用户扩展数据 |
void notifyInviteAccepted(String inviteID, String usrExtDat)
- 功能:通知邀请被接受
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | String | 邀请ID |
usrExtDat | String | 用户扩展数据 |
void notifyInviteRejected(String inviteID, CRVIDEOSDK_ERR_DEF reason, String usrExtDat)
- 功能:通知邀请被拒绝
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | String | 邀请ID |
reason | CRVIDEOSDK_ERR_DEF | 邀请被拒绝原因,定义见ERR_DEF |
usrExtDat | String | 用户扩展数据 |
void notifyInviteCanceled(String inviteID, CRVIDEOSDK_ERR_DEF reason, String usrExtDat)
- 功能:通知邀请被取消
- 参数:
参数 | 类型 | 含义 |
---|---|---|
inviteID | String | 邀请ID |
reason | CRVIDEOSDK_ERR_DEF | 邀请被取消原因,定义见ERR_DEF |
usrExtDat | String | 用户扩展数据 |
CloudroomVideoMeeting接口详情
房间核心组件,实现通话建立、音频采集播入、视频采集编解码、屏幕共享、录制、影音播放等功能。整个程序的生命过程中只能有一个实例。
void registerCallBack(CloudroomVideoCallback callBack)
-
功能: 注册监听回调
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callBack | CloudroomVideoCallback | 回调对象 |
void unregisterCallBack(CloudroomVideoCallback callBack)
-
功能: 反注册监听回调
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callBack | CloudroomVideoCallback | 反注册的回调对象 |
void enterMeeting(int meetID, String nickname)
-
功能: 使用房间ID和昵称进入指定的视频房间
-
返回值: 无
回调函数enterMeetingRslt
参数 | 类型 | 含义 |
---|---|---|
meetID | int | 视频房间ID |
nickname | String | 房间内昵称 |
void exitMeeting()
-
功能: 离开房间 ,调用此接口离开会话时,其他会话用户会收到userLeftMeeting的消息通知
-
返回值: 无
回调函数userLeftMeeting
void kickout(String userID)
-
功能: 把某个房间成员踢出房间
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userId | String | 用户ID |
ArrayList<MemberInfo> getAllMembers()
-
功能: 获取所有用户的信息
-
返回值: ArrayList<MemberInfo>-所有用户的信息
MemberInfo getMemberInfo(String userId)
-
功能: 获取某个用户的信息
-
返回值: MemberInfo - 用户的信息
参数 | 类型 | 含义 |
---|---|---|
userId | String | 用户ID |
String getNickName(String userId)
-
功能: 获取某个用户的昵称
-
返回值: 用户的昵称
参数 | 类型 | 含义 |
---|---|---|
userId | String | 用户ID |
void setNickName(String userID, String nickName)
-
功能: 设置某个用户的昵称, 调用此接口如果设置成功,其他会话用户会收到 notifyNickNameChanged
-
返回值: 无
回调函数setNickNameRsp
参数 | 类型 | 含义 |
---|---|---|
userId | String | 用户ID |
nickname | String | 新的用户昵称 |
boolean isUserInMeeting(String userID)
-
功能: 判断某个用户是否在房间中
-
返回值: 用户是否在房间中
参数 | 类型 | 含义 |
---|---|---|
userId | String | 用户ID |
void setAudioCfg(AudioCfg cfg)
-
功能: 设置麦克风音频参数
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
cfg | AudioCfg | 音频参数 |
AudioCfg getAudioCfg()
-
功能: 获取音频参数
-
返回值: AudioCfg-音频参数
boolean setMicVolumeScaling(float scale)
-
功能: 设置麦克风音量增益
-
返回值: 是否成功
参数 | 类型 | 含义 |
---|---|---|
scale | float | 麦克风音量增益(范围:0~10),取值0~10, 其中0相当于静音,<1.0是变小, =1.0原始, >1.0是放大 |
int getMicEnergy(String userID)
-
功能: 获取用户说话声音大小
-
返回值: 音量大小(0~10)
参数 | 类型 | 含义 |
---|---|---|
userID | String | 用户的ID |
void openMic(String userID)
-
功能: 打开用户的麦克风, 打开麦克风会触发音频状态变化的回调函数audioStatusChanged 新状态参数先会进入到AOPENING状态,
等服务器处理后才会进入AOPEN状态,此时说话才能被采集到 -
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userID | String | 用户的ID |
void closeMic(String userID)
-
功能: 关闭用户的麦克风 ,关麦克风会触发音频状态变化的回调函数audioStatusChanged 新状态参数会变为ACLOSE 关麦操作是立即生效的,会立即停止采集
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userID | String | 用户的ID |
ASTATUS getAudioStatus(String userID)
-
功能: 获取用户的麦状态
-
返回值: ASTATUS-麦克风设备状态
参数 | 类型 | 含义 |
---|---|---|
userID | String | 用户的ID |
boolean setMicVolume(int level)
-
功能: 设置本地麦音量
-
返回值: 是否成功
参数 | 类型 | 含义 |
---|---|---|
level | int | 本地麦音量 |
int getMicVolume()
-
功能: 获取本地麦音量 ,读写属性,音量等级类型 0-255
-
返回值: 本地麦音量
boolean setSpeakerVolume(int level)
-
功能: 设置本地扬声器音量
-
返回值: 是否成功
参数 | 类型 | 含义 |
---|---|---|
level | int | 本地扬声器音量,取值:0-255 |
int getSpeakerVolume()
-
功能: 获取本地扬声器音量 ,读写属性,音量等级类型 0-255
-
返回值: 本地扬声器音量
void setSpeakerMute(boolean bMute)
-
功能: 设置播放是否静音
-
返回值: 是否静音
参数 | 类型 | 含义 |
---|---|---|
bMute | boolean | 播放是否静音 |
boolean getSpeakerMute()
-
功能: 获取播放是否静音
-
返回值: 是否静音
boolean setSpeakerOut(boolean speakerOut)
-
功能: 设置外放状态
-
返回值: 是否成功
参数 | 类型 | 含义 |
---|---|---|
speakerOut | boolean | 是否外放 |
boolean getSpeakerOut()
-
功能: 获取外放状态
-
返回值: 是否外放
void setAllAudioClose()
- 功能: 关闭所有用户的麦克风 , 调用此接口后会话内其他人的麦克风会关闭,同时收到消息audioStatusChanged
- 返回值: 无
ArrayList<UsrVideoInfo> getAllVideoInfo(String userId)
-
功能: 获取用户所有的摄像头信息
-
返回值: ArrayList<UsrVideoInfo>-用户所有的摄像头信息
参数 | 类型 | 含义 |
---|---|---|
userID | String | 用户ID |
void setAudioFrameObserver(AudioFrameObserver p)
- 功能:设置语音观测器
传入NULL,代表移除观测器;
此接口线程安全;
-
返回值: 无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
p | AudioFrameObserver | 音频观测器对象 |
void setAudioSubscribeMode(ASUBSCRIB_MODE mode)
- 功能:设置音频订阅模式
sdk内部默认为ASM_MIXED模式,此模式进入房间成功就能听到房间内所有开麦人的声音;
配置为ASM_SEPARATE模式后,默认不订阅任何人的声音,需要调用setAudioSubscribeListForSeparateMode设置要订阅的人员名单;
此接口在进入房间前可调用, 程序退出后失效;
-
返回值: 无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
mode | ASUBSCRIB_MODE | 订阅模式 |
void setAudioSubscribeListForSeparateMode(ASUBSCRIB_LISTTYPE type, List<String< userIds)
- 功能:设置独立音频订阅名单
只有在ASM_SEPARATE音频订阅模式下才能设置,可调用setAudioSubscribeMode修改模式;
切换到其它音频订阅模式时,之前设置的名单自动失效;
此接口在进入房间前可调用,程序退出后失效;
白名单和黑名单不共存,后面的数据将覆盖之前的数据;
其他人员进出房间、开关麦,不影响设置的名单;sdk内部会退订离开或关麦的流,在开麦后再次订阅;
-
返回值: 无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
type | ASUBSCRIB_LISTTYPE | 列表类型 |
userIds | List<String< | 用户ID列表 |
CRVIDEOSDK_ERR_DEF startEchoTest()
-
功能: 开始本地语音环回测试
-
返回值: 无
void stopEchoTest()
-
功能: 停止本地语音环回测试
-
返回值: 无
boolean isEchoTesting()
-
功能: 检测是否在本地语音环回测试
-
返回值: 无
-
返回值: 是否测试中
- (int)getLocMicDevEnergy
-
功能: 获取本地麦克风设备能量等级
-
返回值: 无
-
返回值: 能量等级0~9, (9为最大能量等级)
void setVoiceChange(String userID, int type)
-
功能: 设置指定人变声
-
返回值: 无
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userID | String | 用户ID |
type | int | 预定义变声类型,见CRVOICECHANGE_TYPE |
int getVoiceChangeType(String userID)
-
功能: 获取目标用户变声类型
-
返回值: 无
-
返回值: 预定义变声类型,参考CRVOICECHANGE_TYPE
参数 | 类型 | 含义 |
---|---|---|
userID | String | 用户ID |
CRVIDEOSDK_ERR_DEF setCustomAudioCapture(boolean enable, String param)
-
功能: 自定义音频采集
-
返回值: 无
-
返回值: 调用结果,CRVIDEOSDK_NOERR 代表调用成功,详情见CRVIDEOSDK_ERR_DEF
参数 | 类型 | 含义 |
---|---|---|
enable | bool | 是否启用自定义音频采集 |
param | String | 可选扩展参数,json格式,当前支持参数: |
"fromIPCam":摄像头ID,配置后将不再需要pushCustomAudioDat,sdk自动从IPCam中获取音频数据 |
CRVIDEOSDK_ERR_DEF pushCustomAudioDat(ByteBuffer pcmDat)
-
功能: 向sdk送入自定义音频采集数据
-
返回值: 无
-
返回值: 调用结果,CRVIDEOSDK_NOERR 代表调用成功,详情见CRVIDEOSDK_ERR_DEF
参数 | 类型 | 含义 |
---|---|---|
pcmDat | ByteBuffer | 音频帧数据 |
CRVIDEOSDK_ERR_DEF setCustomAudioPlayback(boolean enable, String param)
-
功能: 自定义音频渲染
-
返回值: 无
-
返回值: 调用结果,CRVIDEOSDK_NOERR 代表调用成功,详情见CRVIDEOSDK_ERR_DEF
参数 | 类型 | 含义 |
---|---|---|
enable | bool | 是否开启自定义音频播放 |
param | String | 保留参数 |
ByteBuffer pullCustomAudioDat()
-
功能: 从sdk获取音频数据用于自渲染
-
返回值: 音频帧数据
- (StreamInfo *)getVideoStreamInfo:(UsrVideoId *)cam
-
功能: 获取摄像头流信息
-
返回值: 流信息StreamInfo
short createCustomVideoDev(String camName, VIDEO_FORMAT pixFmt, int width, int height, String extParams)
-
功能: 创建自定义摄像头(sdk最大支持5个), 添加成功后与本地摄像头处理一致;getAllVideoInfo接口可以识别摄像头类型
-
返回值: 返回值小于0, 则代表创建失败, 返回值大于等于0, 则代表摄像头编号
参数 | 类型 | 含义 |
---|---|---|
camName | String | 摄像头名称 |
pixFmt | VIDEO_FORMAT | 图像格式 |
width | int | 图像宽度 |
height | int | 图像高度 |
extParams | String | 扩展参数,没有为空 |
void destroyCustomVideoDev(short videoID)
-
功能: 消毁自定义摄像头
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
videoID | short | 摄像头id (createCustomVideoDev返回值) |
void inputCustomVideoDat(short videoID, byte[] data, int timeStamp)
-
功能: 输入摄像头图像数据
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
videoID | short | 摄像头id (createCustomVideoDev返回值) |
data | byte[] | 图像数据(请保证格式、和尺寸与摄像头匹配) |
timeStamp | int | 保留字段,请填0 |
void inputCustomVideoDat(short videoID, byte[] data, int timeStamp)
-
功能: 输入摄像头图像数据
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
videoID | short | 摄像头id (createCustomVideoDev返回值) |
data | byte[] | 图像数据(请保证格式、和尺寸与摄像头匹配) |
timeStamp | int | 保留字段,请填0 |
void setVideoCfg(VideoCfg cfg)
-
功能: 设置摄像头参数
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
cfg | VideoCfg | 摄像头参数 |
VideoCfg getVideoCfg()
-
功能: 获取设置的摄像头参数
-
返回值: VideoCfg-摄像头参数
void setVideoEffects(VideoEffects effects)
-
功能: 配置视频效果
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
cfg | VideoEffects | 视频效果配置 |
VideoCfg getVideoEffects()
-
功能: 获取视频效果配置
-
返回值: VideoEffects-视频效果配置
void setLocVideoAttributes(short videoID, VideoAttributes attributes)
-
功能: 设置某个摄像头私有参数
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
videoID | short | 本地摄像头id |
attributes | VideoAttributes | 摄像头私有参数, |
VideoAttributes getLocVideoAttributes(short videoID)
-
功能: 获取某个摄像头私有参数
-
返回值: VideoAttributes-摄像头私有参数
参数 | 类型 | 含义 |
---|---|---|
videoID | short | 本地摄像头id |
ArrayList<UsrVideoId> getWatchableVideos()
-
功能: 获取房间内所有可观看的摄像头
-
返回值: ArrayList<UsrVideoId>-房间内所有可观看的摄像头
void openVideo(String userID)
-
功能: 打开用户的摄像头,以便本地、远端显示视频图像
-
返回值: 无
回调函数openVideoRslt, 调用打开和关闭麦克风接口都会触发对应用户的回调videoStatusChanged
参数 | 类型 | 含义 |
---|---|---|
userID | String | 用户的ID |
void closeVideo(String userID)
-
功能: 关闭用户的摄像头 ,
-
返回值: 无
调用打开和关闭麦克风接口都会触发对应用户的回调videoStatusChanged
参数 | 类型 | 含义 |
---|---|---|
userID | String | 用户的ID |
VSTATUS getVideoStatus(String userID)
-
功能: 获取用户的摄像头状态
-
返回值: VSTATUS-麦克风摄像头状态
参数 | 类型 | 含义 |
---|---|---|
userID | String | 用户的ID |
short getDefaultVideo(String userID)
-
功能: 获取指定用户的默认摄像头 ,如果用户没有摄像头,返回0
-
返回值: 摄像头ID
参数 | 类型 | 含义 |
---|---|---|
userID | String | 用户的ID |
void setDefaultVideo(String userID, short videoID)
-
功能: 设置默认的摄像头 ,videoID 应该从getAllVideoInfo返回值中获取
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userID | String | 用户的ID |
videoID | short | 摄像头ID |
参数 | 类型 | 含义 |
---|---|---|
usrVideoID | UsrVideoId | 用户摄像头ID |
VideoFrame getVideoImg(UsrVideoId usrVideoID)
VideoFrame getVideoImg(UsrVideoId usrVideoID, VIDEO_FORMAT fmt)
VideoFrame getVideoImg(UsrVideoId usrVideoID, Size size)
VideoFrame getVideoImg(UsrVideoId usrVideoID, Size size, VIDEO_FORMAT fmt)
-
功能: 获取指定用户摄像头的最新图像
-
返回值: 指定用户摄像头的最新图像,详见VideoFrame
参数 | 类型 | 含义 |
---|---|---|
usrVideoID | UsrVideoId | 用户摄像头标识ID,详见定义UsrVideoId |
size | Size | 图像大小,详见定义Size |
fmt | VIDEO_FORMAT | 图像格式,详见定义VIDEO_FORMAT |
String getLocalVideoParams(short videoID)
-
功能: 获取指定本地摄像头参数
-
返回值: 指定本地摄像头参数,json格式,如{"摄像头参数名称":[可用参数列表]}
参数 | 类型 | 含义 |
---|---|---|
videoID | short | 摄像头ID |
void setLocalVideoParam(short videoID, String param, String value)
-
功能: 设置指定本地摄像头参数
-
返回值: 指定本地摄像头参数,json格式,如{"摄像头参数名称":[可用参数列表]}
参数 | 类型 | 含义 |
---|---|---|
videoID | short | 摄像头ID |
param | String | 摄像头参数名称 |
value | String | 摄像头参数值 |
CRVSDK_ERR_DEF startBeauty(String params)
- 功能:开启美颜功能
开启美颜成功后,将带来不少gpu开销,且视频分辨率越高开销将越大;
支持多种美颜滤镜叠加,但叠加的越多,gpu开销越大;(当滤镜强度为0时,对应滤镜将不再带来开销)
当前美颜功能,只对默认摄像头生效,切换默认摄像头时内部自动对新的默认摄像头进行美颜处理;
-
返回值: CRVSDK_ERR_DEF,CRVSDKERR_NOERR代表调用成功
-
参数:
参数 | 类型 | 含义 |
---|---|---|
params | String | 美颜参数,参见CRBeautyCfg |
void stopBeauty()
-
功能:停止美颜功能
-
返回值:无
boolean isBeautyStarted()
-
功能:获取美颜功能是否开启
-
返回值: boolean
CRVSDK_ERR_DEF updateBeautyParams(String params)
-
功能:更新美颜参数
-
返回值: CRVSDK_ERR_DEF,CRVSDKERR_NOERR代表调用成功
-
参数:
参数 | 类型 | 含义 |
---|---|---|
params | String | 美颜参数,参见CRBeautyCfg |
String getBeautyParams()
-
功能:获取当前美颜参数
-
返回值:美颜配置,json格式,请参见CRBeautyCfg
boolean isScreenShareStarted()
-
功能: 获取屏幕共享是否已开启
-
返回值: 屏幕共享是否已开启
string getScreenShareCfg()
-
功能: 获取屏幕共享配置
-
返回值:屏幕共享配置,参见ScreenShareCfg
void setScreenShareCfg(ScreenShareCfg cfg)
-
功能: 设置屏幕共享配置
-
返回值:无
参数 | 类型 | 含义 |
---|---|---|
string | ScreenShareCfg | 屏幕共享配置 |
void startScreenShare()
-
功能: 开启屏幕共享
-
返回值:无
-
注意事项:
+ 共享屏幕需要相应授权,请添加下面权限申请界面声明到主配置文件
<activity
android:name="com.rtc.screencapture.PermissionActivity"
android:configChanges="orientation|uiMode|screenLayout|screenSize|smallestScreenSize|locale|fontScale|keyboard|keyboardHidden|navigation"
android:launchMode="singleTop"
android:screenOrientation="sensor" >
</activity>
void setCustomizeCatchScreen(boolean newVal)
-
功能: 开启/关闭自定义的抓屏
-
返回值:无
参数 | 类型 | 含义 |
---|---|---|
newVal | boolean | 开启后,应按fps周期调用setCustomizeScreenImg送入图像 |
void setCustomizeScreenImg(final View view)
void setCustomizeScreenImg(final Bitmap bitmap)
-
功能: 送入自定义的抓屏图像数据
-
返回值:无
参数 | 类型 | 含义 |
---|---|---|
view | View | 抓View的显示图像 |
bitmap | Bitmap | 图像数据 |
void stopScreenShare()
-
功能: 停止屏幕共享
-
返回值:无
void startScreenMark()
-
功能: 开始屏幕共享标注
-
返回值: 无
void stopScreenMark()
-
功能: 停止屏幕共享标注
-
返回值: 无
void enableOtherMark(boolean enable)
-
功能:允许他人标注屏幕
-
返回值:无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
enable | boolean | 是否允许他人标注 |
boolean isEnableOtherMark()
-
功能:获取是否允许他人标注屏幕
-
返回值: 是否允许他人标注
-
参数:
CRVIDEOSDK_ERR_DEF createLocMixer(String mixerID, MixerCfg mixerCfg, ArrayList< MixerCotent> mixerContent)
-
功能: 创建本地混图器(用于本地录制、本地推流),当需要多个不同内容的录制、或直播时,就要创建多个混图器 。混图器开消比较大,多个同样图像的输出应该有一个混图器加上多个输出实现
-
返回值: CRVIDEOSDK_ERR_DEF-操作结果码
参数 | 类型 | 含义 |
---|---|---|
mixerID | String | 混图器唯一标识 |
mixerCfg | MixerCfg | 混图器规格配置 |
mixerContents | ArrayList<MixerCotent> | 混图器内容配置 |
CRVIDEOSDK_ERR_DEF updateLocMixerContent(String mixerID, ArrayList< MixerCotent> mixerContents>
-
功能: 更新本地混图器内容
-
返回值: CRVIDEOSDK_ERR_DEF-操作结果码
参数 | 类型 | 含义 |
---|---|---|
mixerID | String | 混图器唯一标识 |
MixerContents | ArrayList<MixerCotent> | 混图器内容配置 |
void destroyLocMixer(String mixerID)
-
功能: 消毁本地混图器 , 消毁本地混图器后, 基于此混图器的录制输出、直播推流输出将自动结束
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
mixerID | String | 混图器唯一标识 |
MIXER_STATE getLocMixerState(String mixerID)
-
功能: 获取本地混图器状态
-
返回值: MIXER_STATE-混图器状态
参数 | 类型 | 含义 |
---|---|---|
mixerID | String | 混图器唯一标识 |
CRVIDEOSDK_ERR_DEF addLocMixerOutput(String mixerID, ArrayList<MixerOutPutCfg> mixerOutput)
-
功能: 开启本地录制、开启直播推流
-
返回值: CRVIDEOSDK_ERR_DEF-操作结果码
参数 | 类型 | 含义 |
---|---|---|
mixerID | String | 混图器唯一标识 |
mixerOutput | ArrayList<MixerOutPutCfg> | 本地输出对象 |
-
注意事项:
- 可以一次添加多个输出,也可以依据业务需要稍后再添加新的输出
- 多个输出不能同名、或同一url
- 每个输出,有独立的信息通知,请见事件locMixerOutputInfo
- 如果输出异常时,将自动停止, 停止本地录制、直播推流
void rmLocMixerOutput(String mixerID, ArrayList<String> nameOrUrls)
-
功能: 停止本地录制、直播推流 , 所有输出停止后并不会消毁混图器,如果混图器不再需要请手工消毁
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
mixerID | String | 混图器唯一标识 |
nameOrUrls | ArrayList<String> | 要停止的录制文件名或直播url列表 |
String createCloudMixer(string cfg)
- 功能:创建云端混图器
可以开启多个云端混图器,具体个数和企业购买的授权相关;
开启云端混图器后,房间内所有人都将收到cloudMixerStateChanged通知进入MIXER_STARTING(启动中状态);
云端混图器部署有少量耗时,如果在部署过程遇到异常,将收到createCloudMixerFailed回调;
云端混图器启动完成并进入录制或推流状态时,将收到cloudMixerStateChanged通知,进入MIXER_RUNNING(工作中状态);
开启云端混图器在进入MIXER_STARTING状态后,可以通过updateCloudMixerContent更新内容;
混图器如果在工作中遇到异常而停止时,将收到cloudMixerStateChanged通知,进入MIXER_NULL并携带错误原因;
-
返回值: 云端混图器ID
-
参数:
参数 | 类型 | 含义 |
---|---|---|
cfg | string | 云端混图器配置,josn格式,参见CloudMixerCfg |
CRVIDEOSDK_ERR_DEF updateCloudMixerContent(String mixerID, String cfg)
- 功能:更新云端混图器
更新混图器内容时,只能更新内容和布局,不能更改混图器规格、输出目标;
更新混图器内容时,房间内所有人都将收到cloudMixerInfoChanged通知;
-
返回值: CRVIDEOSDK_ERR_DEF,CRVIDEOSDK_NOERR代表调用成功
-
参数:
参数 | 类型 | 含义 |
---|---|---|
mixerID | String | 混图器ID, 参见createCloudMixer |
cfg | String | 混图器内容配置,josn格式,参见CloudMixerCfg |
void destroyCloudMixer(String mixerID)
- 功能:消毁云端混图器
消毁云端混图器时,调用者将收到cloudMixerStateChanged通知进入MIXER_STOPPING状态,在停止完成后,房间内所有人都将收到cloudMixerStateChanged通知进入MIXER_NULL状态;
-
返回值: 无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
mixerID | String | 混图器ID, 参见createCloudMixer |
string getAllCloudMixerInfo()
-
功能:得到所有云端混图器信息
-
返回值: json格式字符串, 参见CloudMixerInfoList
String getCloudMixerInfo(String mixerID)
-
功能:得到云端混图器信息
-
返回值: json格式字符串, 参见CloudMixerInfo
-
参数:
参数 | 类型 | 含义 |
---|---|---|
mixerID | String | 混图器ID, 参见createCloudMixer |
void setMediaCfg(VideoCfg cfg)
-
功能: 配置远程影音共享时,图像质量参数
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
cfg | VideoCfg | 影音共享配置参数 |
VideoCfg getMediaCfg()
-
功能: 获取影音共享配置参数
-
返回值: VideoCfg-影音共享配置参数
void startPlayMedia(String filename, boolean bLocPlay)
-
功能: 播放影音文件
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
filename | String | 文件名,全路径 |
bLocPlay | int | 是否仅仅本地播放(true:本地播放,false:房间内播放) |
void startPlayMedia(String filename, int bLocPlay, boolean bPauseWhenFinished)
-
功能: 播放影音文件
-
返回值: 无
播放视频则触发回调notifyMediaOpened, 停止播放则触发回调notifyMediaStop
参数 | 类型 | 含义 |
---|---|---|
filename | String | 文件名,全路径 |
bLocPlay | int | 是否仅仅本地播放(1:本地播放,0:房间内播放) |
bPauseWhenFinished | boolean | 是否停在最后一帧, 如果播放成功,其他人收到notifyMediaStart,如果播放失败,请关注通知事件notifyMediaStop |
void pausePlayMedia(boolean bPause)
-
功能: 暂停播放影音
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
bPause | boolean | 是否暂停 |
void stopPlayMedia()
-
功能: 停止影音播放
-
返回值: 无
回调函数notifyMediaStop
void setMediaPlayPos(int pos)
-
功能: 设置播放进度
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
pos | int | 设置播放位置,单位:毫秒 |
ArrayList<String> getAllFilesInMediaPath()
- 功能: 取得影音文件夹下的所有可播放文件
- 返回值: 文件名列表
参数 | 类型 | 含义 |
---|---|---|
pos | int | 设置播放位置,单位:毫秒 |
-
注意事项:
-
影音文件夹位于方法init的第二个参数sdkFilePath,sdk会在此文件中建立media的子文件夹,即为影音文件夹
MediaInfo getMediaInfo()
-
功能: 正在播放的影音信息
-
返回值: MediaInfo-影音文件信息
void setMediaVolume(int level)
- 功能: 设置影音播放的音量
- 返回值: 无
参数 | 类型 | 含义 |
---|---|---|
level | int | 影音播放的音量,类型范围(0-255) |
int getMediaVolume()
-
功能: 读取影音播放的音量
-
返回值: 影音播放的音量,类型范围(0-255)
参数 | 类型 | 含义 |
---|---|---|
userID | String | 用户id |
void setPicResource(String resID, Bitmap bitmap)
-
功能: 将图片资源设置给sdk
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
resID | String | 资源唯一标识 |
bitmap | Bitmap | 图片对象,为空代表移除资源 |
void setPicResource(String resID, String picFile)
-
功能: 将图片资源设置给sdk
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
resID | String | 资源唯一标识 |
picFile | Bitmap | 资源文件路径,为空代表移除资源 |
boolean setPicResource(String resID, View view)
-
功能: 将图片资源设置给sdk
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
resID | String | 资源唯一标识 |
view | View | 控件对象,为空代表移除资源(注:不能是opengl显示控件,必须是在界面已经显示的控件) |
boolean setPicResource(String resID, View view, Size size)
-
功能: 将图片资源设置给sdk
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
resID | String | 资源唯一标识; |
view | Bitmap | 控件对象,为空代表移除资源(注:不能是opengl显示控件,必须是在界面已经显示的控件) |
size | Size | size 图片大小 |
void getMeetingAllAttrs(String cookie)
-
功能:获取房间所有属性
-
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
cookie | String | 可为空字符串。详细介绍见关键词 |
void getMeetingAttrs(List<String> keys, String cookie)
-
功能:获取房间部份属性
-
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
keys | List<String> | 需要查询的房间属性key |
cookie | String | 可为空字符串。详细介绍见关键词 |
void setMeetingAttrs(HashMap<String, String> attrs, HashMap<String, Object> options, String cookie)
-
功能:重置房间属性集
-
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
attrs | HashMap<String, String> | 房间属性集,key最大长度为64B,value最大长度为8KB |
options | HashMap<String, Object> | 操作选项 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void addOrUpdateMeetingAttrs(HashMap<String, String> attrs, HashMap<String, Object> options, String cookie)
-
功能:增加或者更新房间属性
-
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
attrs | HashMap<String, String> | 房间属性集,json格式,key最大长度为64B,value最大长度为8KB |
options | HashMap<String, Object> | 操作选项 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void delMeetingAttrs(List<String> keys, HashMap<String, Object> options, String cookie)
-
功能:删除房间属性
-
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
keys | List<String> | 需要删除的房间属性key,json格式,如["key1","key2"] |
options | HashMap<String, Object> | 操作选项 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void clearMeetingAttrs(HashMap<String, Object> options, String cookie)
-
功能:清除房间所有属性
-
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
options | HashMap<String, Object> | 操作选项 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void getUserAttrs(String userIds, List<String> keys, String cookie)
-
功能:获取指定用户的指定属性
-
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userIds | string | 目标用户id列表,一次最多包含50个用户,json格式, 如:["userId1","userId2"] |
keys | List<String> | 将要获取的用户属性key列表(空串代表获取全部),json格式,如:["key1","key2"] |
cookie | String | 可为空字符串。详细介绍见关键词 |
void setUserAttrs(String userId, string attrs, HashMap<String, Object> options, String cookie)
-
功能:重置用户属性
-
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userId | String | 目标用户id |
attrs | HashMap<String, String> | 用户属性集, json格式,如:{"key1":"value1", "key2":"value2"} (key最大长度为64B,value最大长度为8KB) |
options | HashMap<String, Object> | 操作选项 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void addOrUpdateUserAttrs(String userId, string attrs, HashMap<String, Object> options, String cookie)
-
功能:增加或更新用户属性
-
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userId | String | 目标用户id |
attrs | HashMap<String, String> | 用户属性集, json格式,如:{"key1":"value1", "key2":"value2"} (key最大长度为64B,value最大长度为8KB) |
options | HashMap<String, Object> | 操作选项 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void delUserAttrs(String userId, List<String> keys, HashMap<String, Object> options, String cookie)
-
功能:删除用户的特定属性
-
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userId | String | 目标用户id |
keys | List<String> | 需要删除的用户属性key列表,json格式,如:["key1","key2"] |
options | HashMap<String, Object> | 操作选项 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void clearAllUserAttrs(HashMap<String, Object> options, String cookie)
-
功能:清除所有用户的所有属性
-
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
options | HashMap<String, Object> | 操作选项 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void clearUserAttrs(String userId, HashMap<String, Object> options, String cookie)
-
功能:清除特定用户的所有属性
-
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userId | String | 目标用户id |
options | HashMap<String, Object> | 操作选项 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void sendMeetingCustomMsg(String text, String cookie)
-
功能:发送房间内自定义广播消息
-
返回值:无
- 参数:
参数 | 类型 | 含义 |
---|---|---|
text | String | 用户自定义消息 |
cookie | String | 可为空字符串。详细介绍见关键词 |
CloudroomVideoMeeting通知回调接口详情
void enterMeetingRslt(CRVIDEOSDK_ERR_DEF sdkErr)
-
功能: 自己进入房间的结果
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果码 |
cookie | String | 自定义用户数据 |
void setNickNameRsp(CRVIDEOSDK_ERR_DEF sdkErr, String userid, String newName)
-
功能: 设置昵称的结果
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果码 |
userid | String | 用户id |
newName | String | 新的昵称 |
void notifyNickNameChanged(String userID, String oldName, String newName)
-
功能: 某用户改变了昵称(改昵称的用户自身不会接收到此通知)
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userID | String | 改变昵称的某用户id |
oldName | String | 改变昵称的某用户昵称(改变之前的昵称) |
newName | String | 改变昵称的某用户昵称(改变之后的昵称) |
void userEnterMeeting(String userID)
-
功能: 某用户进入了房间
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userID | String | 进入房间的用户id |
void userLeftMeeting(String userID)
-
功能: 某用户离开了房间
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userID | String | 离开房间的用户id |
void meetingDropped(CRVIDEOSDK_MEETING_DROPPED_REASON reason)
-
功能: 通知从房间里掉线了,收到该通知后可以调用enterMeeting尝试重新进入房间
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sdkErr | CRVIDEOSDK_MEETING_DROPPED_REASON | 掉线原因 |
-
注意事项:
-
如果用到了呼叫队列,掉线后不重新进入房间就必须调用hangupCall释放本次呼叫
void meetingStoped()
-
功能: 房间已被结束
-
返回值: 无
void netStateChanged(int level)
-
功能: 网络变化通知
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
level | int | 网络状况等级(0~10,10分为最佳网络) |
void audioDevChanged()
-
功能: 通知本地音频设备有变化
-
返回值: 无
void audioStatusChanged(String userID, ASTATUS oldStatus, ASTATUS newStatus)
-
功能: 通知音频状态变化
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userID | String | 房间中设备的所有者 |
oldStatus | ASTATUS | 旧状态 |
newStatus | ASTATUS | 新状态 |
void micEnergyUpdate( String userID, int oldLevel, int newLevel)
-
功能: 通知用户的说话声音强度更新
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userID | String | 用户标识ID |
oldLevel | int | 原来的说话声音强度(0~10) |
newLevel | int | 现在的说话声音强度(0~10) |
void openVideoRslt(String devID, boolean bSuccess)
-
功能: 打开摄像头设备操作结果
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
devID | String | 摄像头设备ID |
bSuccess | boolean | 是否成功 |
void videoStatusChanged(String userID, VSTATUS oldStatus, VSTATUS newStatus)
-
功能: 视频状态变化
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userID | String | 房间中设备的所有者 |
oldStatus | VSTATUS | 旧状态 |
newStatus | VSTATUS | 新状态 |
void videoDevChanged(String userID)
-
功能: 通知用户的视频设备有变化
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
String | String | 设备变化的用户ID |
void notifyVideoData(UsrVideoId usrVideoID, long frameTime)
-
功能: 通知用户有新的视频数据
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
usrVideoID | UsrVideoId | 用户摄像头标识ID |
frmTime | long | 图像的创建时间,可用作时间戳 |
void defVideoChanged(String userID, short videoID)
-
功能: 通知用户的视频默认设备有变化
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userID | String | 设备变化的用户ID |
void uploadRecordFileErr(String fileName, int err)
-
功能: 上传录制文件错误通知
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
fileName | String | 上传文件名 |
err | int | 操作失败代码 |
void locMixerStateChanged(String mixerID, MIXER_STATE state)
-
功能: 本地混图器状态变化通知
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
mixerID | String | 混图器唯一标识 |
state | MIXER_STATE | 状态 |
void locMixerOutputInfo(String mixerID, String nameOrUrl, MixerOutputInfo outputInfo)
-
功能: 本地录制文件、本地直播信息通知
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
mixerID | String | 混图器唯一标识 |
nameOrUrl | String | 录像名称、或直播url |
outputInfo | MixerOutputInfo | 通知内容 |
void startScreenShareRslt(CRVIDEOSDK_ERR_DEF sdkErr)
- 功能: 开启屏幕共享的响应事件
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkEr | CRVIDEOSDK_ERR_DEF | 错误码 |
void stopScreenShareRslt(int sdkErr)
- 功能停止屏幕共享的响应事件
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkEr | CRVIDEOSDK_ERR_DEF | 错误码 |
void notifyScreenShareStarted(String userID)
-
功能: 通知他人开启了屏幕共享
-
返回值: 无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
userID | String | 共享开启人 |
void notifyScreenShareStopped(String oprUserID)
-
功能: 通知他人停止了屏幕共享
-
返回值: 无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
oprUserID | String | 共享停止人 |
void startScreenMarkRslt(CRVIDEOSDK_ERR_DEF sdkErr)
- 功能: 开始屏幕标注结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkEr | CRVIDEOSDK_ERR_DEF | 错误码 |
void stopScreenMarkRslt(int sdkErr)
- 功能: 停止屏幕标注结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkEr | CRVIDEOSDK_ERR_DEF | 错误码 |
void notifyScreenMarkStarted()
-
功能: 通知屏幕标注开始
-
返回值: 无
void notifyScreenMarkStopped()
-
功能: 通知屏幕标注停止
-
返回值: 无
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" : "/sdcard/test.pcm" } |
void stopGetAudioPCM(aSide)
-
功能: 停止获取语音pcm数据
-
返回值:无
参数 | 类型 | 含义 |
---|---|---|
aSide | int | 声道类型 0:麦克风,1:扬声器 |
void notifyMediaOpened(int totalTime, Size picSZ)
-
功能: 通知影音文件打开
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
totalTime | long | 影音时长(毫秒) |
picSZ | Size | 宽高 |
void notifyMediaStart(String userid)
-
功能: 通知影音开始播放
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userid | String | 操作者的用户id |
void notifyMediaPause(String userid, boolean bPause)
-
功能: 通知设置鼠标热点消息
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userid | String | 操作者的用户id |
bPause | boolean | 是否暂停 |
void notifyMediaStop(String userid, int reason)
-
功能: 通知影音播放停止
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userid | String | 操作者的用户id |
reason | int | 播放停止原因,数值参考MEDIA_STOP_REASON |
void notifyPlayPosSetted(int setPTS)
-
功能: 通知播放进度已设置完成
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
setPTS | int | 播放进度 |
void notifyMemberMediaData(String userid, int curPos)
-
功能: 通知影音帧数据已解码完毕
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
userid | String | 操作者的用户id |
curPos | int | 该影音帧的时间,毫秒为单位 |
-
注意事项:
-
收到此通知消息后,可通过getMediaImg获取图像显示;但如果之前显示的帧时戳更大,说明此通知消息已过时,直接忽略即可 如果使用了影音共享UI显示方式,不再需要自已关注此事件和进行显示处理
void notifyAudioPCMDat(int aSide, byte[] audioDat)
-
功能: 通知语音PCM数据
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
aSide | int | 声道类型 |
audioDat | byte[] | PCM数据 |
void notifyAudioErr(CRVSDK_ERR_DEF sdkErr)
-
功能:通知本地音频相关错误
-
返回值:无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
sdkErr | CRVSDK_ERR_DEF | CRVSDK_NOERR代表成功,其它值代表失败的具体原因 |
void getMeetingAllAttrsSuccess(string attrs, String cookie)
- 功能:成功获取到房间所有属性
- 参数:
参数 | 类型 | 含义 |
---|---|---|
attrs | HashMap<String, String> | 房间属性集 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void getMeetingAllAttrsFail(CRVIDEOSDK_ERR_DEF err, String cookie)
- 功能:获取房间属性失败
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | CRVIDEOSDK_ERR_DEF | 错误码,错误码为CRVIDEOSDK_NOERR表示没有错误 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void getMeetingAttrsSuccess(string attrs, String cookie)
- 功能:成功获取到房间指定属性
- 参数:
参数 | 类型 | 含义 |
---|---|---|
attrs | HashMap<String, String> | 房间属性集 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void getMeetingAttrsFail(CRVIDEOSDK_ERR_DEF err, String cookie)
- 功能:获取房间指定属性失败
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | CRVIDEOSDK_ERR_DEF | 错误码,错误码为CRVIDEOSDK_NOERR表示没有错误 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void setMeetingAttrsRslt(CRVIDEOSDK_ERR_DEF err, String cookie)
- 功能:设置用户属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | CRVIDEOSDK_ERR_DEF | 错误码,错误码为CRVIDEOSDK_NOERR表示没有错误 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void addOrUpdateMeetingAttrsRslt(CRVIDEOSDK_ERR_DEF err, String cookie)
- 功能:增加或更新房间属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | CRVIDEOSDK_ERR_DEF | 错误码,错误码为CRVIDEOSDK_NOERR表示没有错误 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void delMeetingAttrsRslt(CRVIDEOSDK_ERR_DEF err, String cookie)
- 功能:删除房间属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | CRVIDEOSDK_ERR_DEF | 错误码,错误码为CRVIDEOSDK_NOERR表示没有错误 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void clearMeetingAttrsRslt(CRVIDEOSDK_ERR_DEF err, String cookie)
- 功能:清除房间属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | CRVIDEOSDK_ERR_DEF | 错误码,错误码为CRVIDEOSDK_NOERR表示没有错误 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void getUserAttrsSuccess(HashMap<String, HashMap<String, MeetingAttr>> attrsMap, String cookie)
- 功能:获取房间内用户属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
attrsMap | HashMap<String, HashMap<String, MeetingAttr>> | 房间属性 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void getUserAttrsFail(CRVIDEOSDK_ERR_DEF err, String cookie)
- 功能:获取房间内用户属性失败
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | CRVIDEOSDK_ERR_DEF | 错误码,错误码为CRVIDEOSDK_NOERR表示没有错误 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void setUserAttrsRslt(CRVIDEOSDK_ERR_DEF err, String cookie)
- 功能:设置用户属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | CRVIDEOSDK_ERR_DEF | 错误码,错误码为CRVIDEOSDK_NOERR表示没有错误 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void addOrUpdateUserAttrsRslt(CRVIDEOSDK_ERR_DEF err, String cookie)
- 功能:增加或者更新用户属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | CRVIDEOSDK_ERR_DEF | 错误码,错误码为CRVIDEOSDK_NOERR表示没有错误 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void delUserAttrsRslt(CRVIDEOSDK_ERR_DEF err, String cookie)
- 功能:删除特定用户属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | CRVIDEOSDK_ERR_DEF | 错误码,错误码为CRVIDEOSDK_NOERR表示没有错误 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void clearAllUserAttrsRslt(CRVIDEOSDK_ERR_DEF err, String cookie)
- 功能:清除所有用户属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | CRVIDEOSDK_ERR_DEF | 错误码,错误码为CRVIDEOSDK_NOERR表示没有错误 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void clearUserAttrsRslt(CRVIDEOSDK_ERR_DEF err, String cookie)
- 功能:清除特定用户属性结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
err | CRVIDEOSDK_ERR_DEF | 错误码,错误码为CRVIDEOSDK_NOERR表示没有错误 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void notifyMeetingAttrsChanged(HashMap<String, MeetingAttr> adds, HashMap<String, MeetingAttr> updates, List<String> delKeys)
- 功能:通知房间属性发生改变
- 参数:
参数 | 类型 | 含义 |
---|---|---|
adds | HashMap<String, MeetingAttr> | 增加房间属性集 |
updates | HashMap<String, MeetingAttr> | 变化的房间属性集 |
delKeys | List<String> | 被删除的房间属性列表 |
void notifyUserAttrsChanged(String userId, HashMap<String, MeetingAttr> adds, HashMap<String, MeetingAttr> updates, List<String> delKeys)
- 功能:通知用户属性发生改变
- 参数:
参数 | 类型 | 含义 |
---|---|---|
userId | String | 变化的用户id |
adds | HashMap<String, MeetingAttr> | 增加的用户属性集 |
updates | HashMap<String, MeetingAttr> | 变化的用户属性集 |
delKeys | List<String> | 被删除的用户属性列表 |
void sendMeetingCustomMsgRslt(CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
- 功能:通知发送房间内自定义广播消息结果
- 参数:
参数 | 类型 | 含义 |
---|---|---|
sdkErr | CRVIDEOSDK_ERR_DEF | 错误码,错误码为CRVIDEOSDK_NOERR表示没有错误 |
cookie | String | 可为空字符串。详细介绍见关键词 |
void notifyMeetingCustomMsg(String fromUserID, String text)
- 功能:通知收到房间内自定义广播消息
- 参数:
参数 | 类型 | 含义 |
---|---|---|
fromUserID | String | 房间内广播消息的发送者的用户id |
text | String | 广播内容 |
void createCloudMixerFailed(String mixerID, CRVIDEOSDK_ERR_DEF sdkErr)
-
功能:启动云端录制、云端直播失败通知
-
返回值:无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
mixerID | string | 混图器ID |
sdkErr | CRVIDEOSDK_ERR_DEF | CRVIDEOSDK_NOERR代表成功,其它值代表失败的具体原因 |
void cloudMixerStateChanged(String mixerID, MIXER_STATE state, String exParam, String operUserID)
-
功能:云端录制、云端直播状态变化通知
-
返回值:无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
mixerID | string | 混图器ID |
state | MIXER_STATE | 录制状态 |
exParam | string | json格式扩展参数,state状态及参数定义: MIXER_NULL:包含err字段(取值为CRVIDEOSDK_ERR_DEF), errDesc字段; MIXER_STARTING:内容参见CloudMixerCfg |
operUserID | string | 操作者用户ID |
void cloudMixerOutputInfoChanged(String mixerID, String jsonStr)
-
功能:云端录制文件、云端直播输出变化通知
-
返回值:无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
mixerID | string | 混图器ID |
jsonStr | string | json格式,请参见CloudMixerOutputInfo |
void cloudMixerInfoChanged(String mixerID)
- 功能:云端录制、云端直播配置变化通知
可调用:getCloudMixerInfo获取相关信息
-
返回值:无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
mixerID | String | 混图器ID |
boolean isVirtualBackgroundStarted()
-
功能: 检查是否支持虚拟背景功能
-
返回值: true:支持,false:不支持
CRVIDEOSDK_ERR_DEF startVirtualBackground(String params)
-
功能: 启动虚拟背景
-
返回值: CRVIDEOSDK_NOERR代表成功,其它值代表失败的具体原因
参数 | 类型 | 含义 |
---|---|---|
params | String | 虚拟背景参数,参见:CRVirtualBkCfg |
CRVIDEOSDK_ERR_DEF updateVirtualBackgroundParams(String params)
-
功能: 更新虚拟背景参数
-
返回值: CRVIDEOSDK_NOERR代表成功,其它值代表失败的具体原因
参数 | 类型 | 含义 |
---|---|---|
params | String | 虚拟背景参数,参见:CRVirtualBkCfg |
String getVirtualBackgroundParams()
-
功能: 获取虚拟背景参数
-
返回值: 虚拟背景参数,参见:CRVirtualBkCfg
void stopVirtualBackground()
-
功能: 停止虚拟背景
-
返回值: 无
CloudroomQueue接口详情
队列组件,实现队列功能,目的是为了实现用户自动分配。整个程序的生命过程中只能有一个实例。
void registerCallBack(CloudroomQueueCallback callBack)
-
功能: 注册监听回调
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callBack | CloudroomQueueCallback | 回调对象 |
void unregisterCallBack(CloudroomQueueCallback callBack)
-
功能: 反注册监听回调
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
callBack | CloudroomQueueCallback | 指定的反注册回调对象 |
void initQueue(String cookie)
-
功能: 初始化用户队列功能数据
-
返回值: 无
回调函数initQueueDatRslt
参数 | 类型 | 含义 |
---|---|---|
cookie | String | 自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
-
注意事项:
-
在响应回调initQueueDatRslt初始化成功后,才可获取队列队列相关信息
void refreshAllQueueStatus()
-
功能: 刷新所有队列状态信息
-
返回值: 无
-
注意事项:
-
当前排队的队列或服务的队列,sdk自动有状态变化回调;其它队列则需要此函数来查询
ArrayList<QueueInfo> getAllQueueInfo()
-
功能: 获取队列信息
-
返回值: ArrayList<QueueInfo>-队列信息列表
QueueStatus getQueueStatus(int queID)
-
功能: 获指定取队列状态
-
返回值: QueueStatus-队列状态
参数 | 类型 | 含义 |
---|---|---|
queID | int | 队列ID |
QueuingInfo getQueuingInfo()
-
功能: 功能获取我的排队信息
-
返回值: QueuingInfo-我的排队信息
ArrayList<Integer> getServiceQueues()
-
功能: 获取我服务的所有队列
-
返回值: 队列ID列表
VideoSessionInfo getSessionInfo()
-
功能: 获取我的会话信息
-
返回值: VideoSessionInfo-我的会话信息
void startQueuing(int queID, String usrExtDat, String cookie)
-
功能: 客户开始排队
-
返回值: 无
回调函数startQueuingRslt
参数 | 类型 | 含义 |
---|---|---|
queID | int | 排队的队列ID |
usrExtDat | String | 用户排队扩展数据 |
cookie | String | 用户自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void stopQueuing(String cookie)
-
功能: 客户停止排队
-
返回值: 无
回调函数stopQueuingRslt
参数 | 类型 | 含义 |
---|---|---|
cookie | String | 用户自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void startService(int queID, String cookie)
-
功能: 开始服务某个队列(可以多次调用,开启对多个队列的服务)
-
返回值: 无
回调函数startServiceRslt
参数 | 类型 | 含义 |
---|---|---|
queID | int | 排队的队列ID |
cookie | String | 用户自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void startService(int queID, int priority, String cookie)
-
功能: 开始服务某个队列(可以多次调用,开启对多个队列的服务)
-
返回值: 无
回调函数startServiceRslt
参数 | 类型 | 含义 |
---|---|---|
queID | int | 排队的队列ID |
priority | int | 座席优先级(缺省为0, 0为最高优先级, 值越大优先级越低) |
cookie | String | 用户自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
-
注意事项:
-
如果没有开启免打扰,那么系统会自动分配客户:将收到事件autoAssignUser
-
如果开启免打扰,系统就不会分配客户,如需服务客户可调用reqAssignUser
-
座席优先级描述
- 座席优先级只在服务的队列内部有效;
- 客户优先分配给服务此队列优先级最高的,且空闲的座席;
- 优先级相同时,则分配给最先空闲的座席;
- 优先级高的座席变空闲时,不抢夺已分配的客户;
void stopService(int queID, String cookie)
-
功能: 停止服务某个队列
-
返回值: 无
回调函数stopServiceRslt
参数 | 类型 | 含义 |
---|---|---|
queID | int | 排队的队列ID |
cookie | String | 用户自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void reqAssignUser(String cookie)
-
功能: 请求分配一个客户
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
cookie | String | 用户自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
-
注意事项:
-
当关闭免打扰时,系统将自动分配客户,无需调用此函数
-
当开启免打扰时,系统不再自动分配客户,座席如需服务客户可使用此函数分配
void acceptAssignUser(int queID, String userID, String cookie)
-
功能: 接受系统安排的客户
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
queID | int | 排队的队列ID |
userID | String | 队列中的用户ID |
cookie | String | 用户自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void rejectAssignUser(int queID, String userID, String cookie)
-
功能: 拒绝系统安排的客户
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
queID | int | 排队的队列ID |
userID | String | 队列中的用户ID |
cookie | String | 用户自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
CloudroomQueue通知回调接口详情
void initQueueDatRslt(CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 队列初始化操作结果
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果代码,成功为CRVIDEOSDK_NOERR |
cookie | String | 用户自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void queueStatusChanged(QueueStatus queStatus)
-
功能: 队列状态变化通知
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
queStatus | QueueStatus | 新的队列状态 |
-
注意事项:
-
在排队的队列、或服务的队列发生变化时,将有队列状态变化通知到来
-
在调用refreshAllQueueStatus时,查询到的队列数据有变化时,会有通知到来
void queuingInfoChanged(QueuingInfo queuingInfo)
-
功能: 排队信息变化通知
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
queuingInfo | QueuingInfo | 排队信息 |
void startQueuingRslt(CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 开始排队操作结果
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果代码,CRVIDEOSDK_NOERR为成功操作 |
cookie | String | 用户自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void stopQueuingRslt(CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 停止排队操作结果
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果代码,CRVIDEOSDK_NOERR为成功操作 |
cookie | String | 用户自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void startServiceRslt(int queID, CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 开始服务队列操作结果
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
queID | int | 排队的队列ID |
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果代码,CRVIDEOSDK_NOERR为成功操作 |
cookie | String | 用户自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void stopServiceRslt(int queID, CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 停止服务队列操作结果
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
queID | int | 排队的队列ID |
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果代码,CRVIDEOSDK_NOERR为成功操作 |
cookie | String | 用户自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void reqAssignUserRslt(CRVIDEOSDK_ERR_DEF sdkErr, UserInfo usr, String cookie)
-
功能: 停止服务队列操作结果
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果代码,CRVIDEOSDK_NOERR为成功操作 |
usr | UserInfo | 请求到的队列用户 |
cookie | String | 用户自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
void autoAssignUser(UserInfo usr)
-
功能: 队列系统自动分配客户
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
usr | UserInfo | 请求到的队列用户 |
-
注意事项:
-
如果想停止系统的自动分配,请调用CloudroomVideoMgr中的 setDNDStatus 设置免打扰功能。
void cancelAssignUser(int queID, String userID)
-
功能: 队列系统取消之前自动分配的的客户
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
queID | int | 服务的队列 |
userID | String | 自动分配用户被取消 |
void responseAssignUserRslt(CRVIDEOSDK_ERR_DEF sdkErr, String cookie)
-
功能: 拒绝、接受分配的用户
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
sdkErr | CRVIDEOSDK_ERR_DEF | 操作结果代码,CRVIDEOSDK_NOERR为成功操作 |
cookie | String | 用户自定义数据(在响应消息中回传给调用者),不需要时传空字符串 |
-
注意事项:
-
队列系统通过接口autoAssignUser给开始队列服务的人自动推送用户,收到系统分配的用户后,
如果队列服务者还未决定接受acceptAssignUser还是拒绝rejectAssignUser推送的用户,系统可用取消本次推送,
并通过本接口通知队列服务者。
可视化组件接口详情
1. 成员视频UI显示组件
com.cloudroom.cloudroomvideosdk.VideoUIView 是视频显示控件,它显示设定的用户的视频,
是由视频房间组件内相关接口的封装而成,如果此方式不满足需求,可以使用视频房间组件内相关的接口自行实现。
多实例方式,在会话中可以为每一个视频用户创建一个用来显示其画面
void setUsrVideoId(UsrVideoId usrVideoId)
-
功能: 设置显示的目标用户视频
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
usrVideoId | UsrVideoId | 目标用户视频ID |
void setUsrVideoId(UsrVideoId usrVideoId, int qualityLv)
-
功能: 设置显示的目标用户视频
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
usrVideoId | UsrVideoId | 目标用户视频ID |
qualityLv | int | 视频档位(1:默认档位,2:对应quality2,3:对应quality3,如果2,3未开启时将显示1档的视频流) |
-
注意事项:
-
从房间内可观看摄像头列表中获取userID和videoID
UsrVideoId getUsrVideoId()
-
功能: 获取当前显示的用户
-
返回值: 用户视频ID
int getPicFrameTime()
- 功能: 获取图像时间戳
- 返回值: 当前图像数据对应的时间戳
boolean isPicEmpty()
- 功能: 检查图像是否为空
- 返回值: 图像是否为空
int getPicWidth()
-
功能: 获取图像宽
-
返回值: 宽
int getPicHeight()
-
功能: 获取图像高
-
返回值: 高
void clear()
-
功能: 清空显示
-
返回值: 无
void setScaleType(int scaleType)
-
功能: 设置图像显示模式
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
scaleType | int | 0:等比缩放留空居中显示; 1:等比缩放裁剪铺满显示; 2:不等比缩放铺满显示(可能导致图像拉伸); |
int getScaleType()
-
功能: 获取视频显示模式
-
返回值: int
0:等比缩放留空居中显示;
1:等比缩放裁剪铺满显示;
2:不等比缩放铺满显示(可能导致图像拉伸);
void setMirrorType(int showMirror)
-
功能: 设置图像镜像模式
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
showMirror | int | 0:自动镜像(前置摄像头左右镜像); 1:不镜像; 2:左右镜像; |
int getScaleType()
-
功能: 获取视频镜像模式
-
返回值: int
0:自动镜像(前置摄像头左右镜像);
1:不镜像;
2:左右镜像;
Bitmap getShowPic()
-
功能: 获取当前显示图像
-
返回值: 当前显示图像
2. 屏幕共享UI显示组件
com.cloudroom.cloudroomvideosdk.ScreenShareUIView 是屏幕共享开启后远端显示控件,
是由视频房间组件内相关接口的封装而成,如果此方式不满足需求,可以使用视频房间组件内相关的接口自行实现。
int getPicFrameTime()
-
功能: 获取图像时间戳
-
返回值: 当前图像数据对应的时间戳
boolean isPicEmpty()
-
功能: 检查图像是否为空
-
返回值: 图像是否为空
int getPicWidth()
-
功能: 获取图像宽
-
返回值: 宽
int getPicHeight()
-
功能: 获取图像高
-
返回值: 高
void clear()
-
功能: 清空显示
-
返回值: 无
void setScaleType(int scaleType)
-
功能: 设置图像显示模式
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
scaleType | int | 0:等比缩放留空居中显示; 1:等比缩放裁剪铺满显示; 2:不等比缩放铺满显示(可能导致图像拉伸); |
int getScaleType()
-
功能: 获取视频显示模式
-
返回值: int
0:等比缩放留空居中显示;
1:等比缩放裁剪铺满显示;
2:不等比缩放铺满显示(可能导致图像拉伸);
Bitmap getShowPic()
-
功能: 获取当前显示图像
-
返回值: 当前显示图像
3. 影音共享UI显示组件
com.cloudroom.cloudroomvideosdk.MediaUIView 影音显示控件,
是由视频房间组件内相关接口的封装而成,如果此方式不满足需求,可以使用视频房间组件内相关的接口自行实现功能。
int getPicFrameTime()
-
功能: 获取图像时间戳
-
返回值: 当前图像数据对应的时间戳
boolean isPicEmpty()
-
功能: 检查图像是否为空
-
返回值: 图像是否为空
int getPicWidth()
-
功能: 获取图像宽
-
返回值: 宽
int getPicHeight()
-
功能: 获取图像高
-
返回值: 高
void clear()
-
功能: 清空显示
-
返回值: 无
void setScaleType(int scaleType)
-
功能: 设置图像显示模式
-
返回值: 无
参数 | 类型 | 含义 |
---|---|---|
scaleType | int | 0:等比缩放留空居中显示; 1:等比缩放裁剪铺满显示; 2:不等比缩放铺满显示(可能导致图像拉伸); |
int getScaleType()
-
功能: 获取视频显示模式
-
返回值: int
0:等比缩放留空居中显示;
1:等比缩放裁剪铺满显示;
2:不等比缩放铺满显示(可能导致图像拉伸);
Bitmap getShowPic()
-
功能: 获取当前显示图像
-
返回值: 当前显示图像
class AudioFrameObserver
音频帧观测器对象;
不能进行耗时处理,将会影响声音的流畅性;
void onRecordAudioFrame(AudioFrame frm)
-
功能:采集的原始音频数据。在子线程回调,需要注意线程安全。
-
返回值:无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
frm | AudioFrame | 声音数据,可被修改 |
void onPlaybackAudioFrame(AudioFrame frm)
-
功能:播放的原始音频数据。在子线程回调,需要注意线程安全。
-
返回值:无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
frm | AudioFrame | 声音数据,可被修改 |
void onPlaybackAudioFrameBeforeMixing(String userID, AudioFrame frm)
-
功能:用户的混音前原始音频数据。在子线程回调,需要注意线程安全。
-
返回值:无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
userID | String | 用户ID, 参见LoginDat的userID字段 |
frm | AudioFrame | 声音数据,可被修改 |
void onMixedAudioFrame(AudioFrame frm)
-
功能:采集+播放混音后数据。在子线程回调,需要注意线程安全。
-
返回值:无
-
参数:
参数 | 类型 | 含义 |
---|---|---|
frm | AudioFrame | 声音数据,可被修改 |