实现音视频通话
简要说明
- 快速创建并进入房间,开始音视频通话;代码部分均为 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请参考: