音视频通话

实现音视频通话

简要说明

  • 快速创建并进入房间,开始音视频通话;代码部分均为 javascript 代码,详细代码请参考 API-Demo 代码。

1. 初始化SDK

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

import { join } from "node:path";
import { getRTCSDK } from "./RTCSDK.js";  //RTCSDK.js 参见集成SDK章节

//用程序所在目录/temp做为SDK的工作目录
const path = join(process.cwd(), '/temp'); 

//首次调用返回Promise,可以在渲染进程main中先调用
getRTCSDK().then((rtcsdk) => {
    const rtcsdk = new RTCSDK();
    rtcsdk.init({
        path: path, //SDK工作目录,用于存储配置文件、临时文件等。 建议使用electron的日志目录
        // enableHardwareAcceleration: true,//启动硬件加速
    });
});

设置回调函数

//登录结果回调
rtcsdk.on("loginRslt", (sdkErr, cookie) => {});
//通知掉线回调 可以弹出提示,或调用登录接口再次重试登录
rtcsdk.on("notifyLineOff", (sdkErr) => {});
//创建房间成功
rtcsdk.on("createMeetingSuccess", (meetID, cookie) => {});
//创建房间失败
rtcsdk.on("createMeetingFail", (sdkErr, cookie) => {});
//进入房间的完成响应
rtcsdk.on("enterMeetingRslt", (sdkErr) => {});
//房间断线通知
rtcsdk.on("notifyMeetingStopped", () => {});
...
//更多回调
...

说明:

SDK继承nodejs的EventEmitter模块实现发布订阅模式
调用SDK接口前,应先订阅SDK回调消息,以便接收SDK回调消息
伴随SDK销毁时,应同时销毁所有监听器

2. 登录连接视频服务器

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

  • 调用接口:
//如果使用云服务时填sdk.cloudroom.com,使用私有化部署的服务器时要填部署的服务器地址;
//此处以云服务为例。
CRLoginDat loginDat;
loginDat._sdkAuthType = CRVSDK_AUTHTP_SECRET;
loginDat._appID = loginAppID;
//appSecret 需要进行md5加密传入进去
loginDat._md5_appSecret = MakeMd5(loginAppSecret.toUtf8());
loginDat._webProtocol = CRVSDK_WEBPTC_HTTP;
loginDat._userID = loginDat._nickName = "昵称"; //用户的昵称

const loginDat = {
  _serverAddr: "sdk.cloudroom.com",
  _sdkAuthType: 1,
  _webProtocol: 1,
  _appID: APPID,
  _md5_appSecret: MD5(AppSecret),
  _userID: "userID",
  _nickName: "昵称",
}

//登录
rtcsdk.login(loginObj);
  • 回调通知:
//登录结果
rtcsdk.on("loginRslt", (sdkErr, cookie) => {
  //若失败 可以弹出错误提示,或调用登录接口再次重试登录
	if (sdkErr !== 0) {
		console.log(`登录失败(错误码: ${sdkErr})`)
		return;
	}
  console.log('登录成功')
})

//通知掉线 可以弹出提示,或调用登录接口再次重试登录
rtcsdk.on("notifyLineOff", (sdkErr) => {
  console.log(`与服务器的连接中断!(错误码: ${sdkErr})`);
})

相关API请参考:

3. 创建房间

  • 调用接口:
//创建房间
rtcsdk.createMeeting();
  • 回调通知:
//创建房间成功
rtcsdk.on("createMeetingSuccess", (meetID, cookie) => {
  console.log('创建房间成功')
})

//创建房间失败 
rtcsdk.on("createMeetingFail", (sdkErr, cookie) => {
  console.log(`创建房间失败(错误码: ${sdkErr})`);
})

相关API请参考:

4. 进入房间

用创建成功的房间信息(房间ID)进入房间,其他用户也是利用此房间信息进入该房间。

  • 调用接口:
//进入房间
rtcsdk.enterMeeting(meetID);
  • 回调通知处理:
//进入房间的完成响应
rtcsdk.on("enterMeetingRslt", (sdkErr) => {
  //若失败 可以弹出错误提示,或调用登录接口再次重试登录
	if (sdkErr !== 0) {
		console.log(`进入房间失败(错误码: ${sdkErr})`)
		return;
	}
  console.log('进入房间成功')
})

//监控房间结束
rtcsdk.on("notifyMeetingStopped", () => {
  console.log('房间已结束')
})

相关API请参考:

5. 打开麦克风/摄像头

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

//打开自己的麦克风
rtcsdk.openMic(myUserID);
//打开自己的摄像头
rtcsdk.openVideo(myUserID);

相关API请参考:

6. 观看自己/他人视频

成功进入房间后,根据自己/他人登录id ,设置并观看其视频图像


//从会议中取到所有参数者,然后按业务逻辑选取想观看他人视频;(以下代码是观看所有人的视频)
const allMember = rtcsdk.getAllMembers().forEach(item => {
  const div = document.createElement('div');
  document.body.appendChild(div);

  //为成员创建videoUI
  const videoUI = rtcsdk.createVideoUI(div);
  videoUI.setVideo({
    type: 0,
    userId: item._userId
  });
})

相关API请参考:

7.退出房间

//退出房间
rtcsdk.exitMeeting();

相关API请参考:

8. 注销登录

//注销本次登录
rtcsdk.logout();

相关API请参考:

9.反初始化,退出SDK

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

//反初始化
rtcsdk.uninit();
rtcsdk = null;

相关API请参考: