Web-SDK

# 实现音视频通话

基本步骤如下：

  1. 初始化SDK
  2. 登录连接视频服务器
  3. 创建房间
  4. 进入房间
  5. 打开麦克风/摄像头
  6. 观看他人视频
  7. 退出房间
  8. 注销登录
  9. 反初始化，退出SDK

1. 初始化SDK

初始化是整个SDK的使用基础，通常在程序启动的时候进行初始化(CRVideo_Init2)，退出后进行反初始化(CRVideo_Uninit)，整个程序的生命周期中只进行一次初始化和反初始化。


//初始化 sdkUsePath  是SDK工作目录，用于存储配置文件、临时文件等，如果传空值，则默认为sdk的安装目录
var init = CRVideo_Init2(sdkUsePath);

//初始化失败会返回对应的错误码
if(init == CRVideo_WEB_OCX_NOTINSTALLED){
    console.log("ocx未安装");

}else if(init == CRVideo_OCX_VERSION_NOTUPPORTED){
    console.log("不支持的浏览器");

}else if(init == CRVideo_WEB_BROWER_NOTUPPORTED){
    console.log("不支持的插件版本");

}else if(init != 0){
    console.log("CRVideo_init2 出错了："+init);

}else if(init == CRVideo_NOERR){
    console.log("初始化成功，可以继续下面第 2 步……");
}

相关API请参考:

2. 登录连接视频服务器

设置视频服务器地址，然后使用appID和md5加密后的appSecret登录。(获取App ID及App Secret)

  • 调用接口：
//设置服务器地址，如果使用云屋的云服务时填www.cloudroom.com，使用私有化部署的服务器时要填部署的服务器地址；此处以云屋的云服务为例。
CRVideo_SetServerAddr("www.cloudroom.com");

//登录
CRVideo_Login(appID, md5(appSecret), nickName, UID);
  • 回调通知：
//登录成功
CRVideo_LoginSuccess.callback = function(userID,cookie){

   //登录成功，开始创建房间，见 第3步
}

//登录失败
CRVideo_LoginFail.callback = function(sdkErr,cookie){

   //登录出错，可以弹出错误提示，或调用登录接口再次重试登录
}

//登录掉线
CRVideo_LineOff.callback=function(sdkErr){

}

相关API请参考:

3. 创建房间

输入房间标题，创建一个没有密码的房间

  • 调用接口：
//创建房间
CRVideo_CreateMeeting("房间的的主题长度50字内")
  • 回调通知：
//创建房间成功
CRVideo_CreateMeetingSuccess.callback=function(meetObj,cookie){
    //创建成功，可以进入房间
}
//创建房间失败
CRVideo_CreateMeetingFail.callback = function(sdkErr,cookie){
    //创建失败，可以弹出错误提示，不能再执行 进入房间
}

相关API请参考:

4. 进入房间

用创建成功的房间信息（房间ID和密码）进入房间，其他用户也是利用此房间信息进入该房间。

  • 调用接口：
//进入房间
CRVideo_EnterMeeting(meetID, meetPswd, UID, nickName, cookie);
  • 回调通知：
//进入房间完成响应
CRVideo_EnterMeetingRslt.callback=function(sdkErr){
    if(sdkErr == CRVideo_NOERR){
         console.log("进入房间成功，可以继续下面第5步……");
    }else{
        console.log("进入房间失败，错误码："+sdkErr);
    }
}
//监控房间掉线
CRVideo_MeetingDropped.callback=function(){

}

相关API请参考:

5. 打开麦克风/摄像头

紧接第4步，进入房间成功后，打开自己的麦克风和摄像头，以便本地、远端显示自己的视频图像

//打开麦克风
CRVideo_OpenMic(UID)

//打开用户的摄像头，共4步
//1.创建
var myVideoUI = CRVideo_CreatVideoObj();  //调用接口，创建控件对象			
myVideoUI.id("me_video_obj");
$("div.meVideoContainer").append(myVideoUI.handler());   //meVideoContainer 为DOM树中显示的div元素，这里是把创建的控件放入DOM树中
     
//2.设置宽高    
myVideoUI.width(480);
myVideoUI.height(270);

//3.打开用户摄像头
CRVideo_OpenVideo(UID)

//4.设置视频流
setTimeout(function(){
    myVideoUI.setVideo(UID);
}, 500);

相关API请参考：

6. 观看他人视频

成功进入房间后，根据他人登录id ，设置并观看他人视频图像

  • 接口调用：
//1.调用接口，创建控件对象，显示他人视频图像
var otherVideoUI = CRVideo_CreatVideoObj();  			
otherVideoUI.id("other_video_obj");
$("div.otherVideoContainer").append(otherVideoUI.handler());   //把创建的控件放入DOM树中
     
//2.设置宽高    
otherVideoUI.width(480);
otherVideoUI.height(270);

//3.设置视频流
setTimeout(function(){
    otherVideoUI.setVideo(UID);  //UID为他人的登录ID
}, 500);

7.退出房间

//退出房间
CRVideo_ExitMeeting()

相关API请参考:

8. 注销登录

//注销本次登录
CRVideo_Logout()

相关API请参考:

9.反初始化，退出SDK

执行反初始化后SDK功能不再可用。

//反初始化
CRVideo_Uninit();

相关API请参考:

← 设置视频属性 →