产品动态
产品近期公告
关于 TRTC Live 正式上线的公告
关于TRTC Conference 正式版上线的公告
Conference 商业化版本即将推出
关于多人音视频 Conference 开启内测公告
关于音视频通话 Call 正式版上线的公告
关于腾讯云音视频终端 SDK 播放升级及新增授权校验的公告
关于 TRTC 应用订阅套餐服务上线的相关说明
跑通直播模式(Electron)
聚焦模式
字号
适用场景
TRTC 支持四种不同的进房模式，其中视频通话（VideoCall）和语音通话（VoiceCall）统称为 通话模式，视频互动直播（Live）和语音互动直播（VoiceChatRoom）统称为直播模式。
直播模式下的 TRTC，支持单个房间最多10万人同时在线，具备小于300ms的连麦延迟和小于1000ms的观看延迟，以及平滑上下麦切换技术。适用低延时互动直播、十万人互动课堂、视频相亲、在线教育、远程培训、超大型会议等应用场景。
原理解析
TRTC 云服务由两种不同类型的服务器节点组成，分别是“接口机”和“代理机”：
接口机
该类节点都采用最优质的线路和高性能的机器，善于处理端到端的低延时连麦通话。
代理机
该类节点都采用普通的线路和性能一般的机器，善于处理高并发的拉流观看需求。
在通话模式下，TRTC 房间中的所有用户都会被分配到接口机上，相当于每个用户都是“主播”，每个用户随时都可以发言（最高的上行并发限制为50路），因此适合在线会议等场景，但单个房间的人数限制为300人。
示例代码
操作步骤
步骤1：尝试跑通官网 SimpleDemo
如果 SimpleDemo 能顺利运行，说明您已经掌握了在项目中安装 Electron 的方法。
反之，如果运行 SimpleDemo 遇到问题，您大概率遭遇了 Electron 的下载、安装问题，此时您可以参考 Electron 官方的 安装指引 。
步骤2：为您的项目集成 trtc-electron-sdk
您可以在我们的官方 Demo 的基础上进行二次开发，项目的起步阶段会比较顺利。
您也可以执行以下指令，把
trtc-electron-sdk 安装到您现有的项目中：npm install trtc-electron-sdk --save
步骤3：初始化 SDK 实例并监听事件回调
创建
trtc-electron-sdk 实例：import TRTCCloud from 'trtc-electron-sdk';let trtcCloud = new TRTCCloud();
监听
onError 事件:// 错误通知是要监听的，需要捕获并通知用户let onError = function(err) {console.error(err);}trtcCloud.on('onError',onError);
步骤4： 组装进房参数 TRTCParams
参数 | 类型 | 说明 | 示例 |
sdkAppId | 数字 | 1400000123 | |
userId | 字符串 | 只允许包含大小写英文字母（a-z、A-Z）、数字（0-9）及下划线和连词符。建议结合业务实际账号体系自行设置。 | test_user_001 |
userSig | 字符串 | eJyrVareCeYrSy1SslI... | |
roomId | 数字 | 数字类型的房间号。如果您想使用字符串形式的房间号，请使用 TRTCParams 中的 strRoomId。 | 29834 |
import {TRTCParams,TRTCRoleType} from "trtc-electron-sdk/liteav/trtc_define";let param = new TRTCParams();param.sdkAppId = 1400000123;param.roomId = 29834;param.userId = 'test_user_001';param.userSig = 'eJyrVareCeYrSy1SslI...';param.role = TRTCRoleType.TRTCRoleAnchor; // 设置角色为"主播"
注意：
TRTC 同一时间不支持两个相同的 userId 进入房间，否则会相互干扰。
每个端在应用场景 appScene 上必须要进行统一，否则会出现一些不可预料的问题。
步骤5：主播端开启摄像头预览和麦克风采音
1. 主播端调用 startLocalPreview() 可以开启本地的摄像头预览，SDK 会向系统请求摄像头使用权限。
2. 主播端调用
setLocalViewFillMode() 可以设定本地视频画面的显示模式：TRTCVideoFillMode.TRTCVideoFillMode_Fill： 模式表示填充，画面可能会被等比放大和裁剪，但不会有黑边。TRTCVideoFillMode.TRTCVideoFillMode_Fit： 模式表示适应，画面可能会等比缩小以完全显示其内容，可能会有黑边。3. 主播端调用 setVideoEncoderParam() 接口可以设定本地视频的编码参数，该参数将决定房间里其他用户观看您的画面时所感受到的 画面质量。
4. 主播端调用 startLocalAudio() 开启麦克风，SDK 会向系统请求麦克风使用权限。
//示例代码：发布本地的音视频流trtcCloud.startLocalPreview(view);trtcCloud.startLocalAudio();trtcCloud.setLocalViewFillMode(TRTCVideoFillMode.TRTCVideoFillMode_Fill);//设置本地视频编码参数let encParam = new TRTCVideoEncParam();encParam.videoResolution = TRTCVideoResolution.TRTCVideoResolution_640_360;encParam.resMode = TRTCVideoResolutionMode.TRTCVideoResolutionModeLandscape;encParam.videoFps = 25;encParam.videoBitrate = 600;encParam.enableAdjustRes = true;trtcCloud.setVideoEncoderParam(encParam);
步骤6：主播端设置美颜效果
1. 主播端可调用 setBeautyStyle(style, beauty, white, ruddiness) 来开启美颜效果
2. 参数说明：
style： 美颜风格，光滑或者自然，光滑风格磨皮更加明显，适合娱乐场景。
TRTCBeautyStyle.TRTCBeautyStyleSmooth: 光滑，适用于美女秀场，效果比较明显。TRTCBeautyStyle.TRTCBeautyStyleNature: 自然，磨皮算法更多地保留了面部细节，主观感受上会更加自然。beauty：美颜级别，取值范围0 - 9，0表示关闭，1 - 9值越大，效果越明显。
white：美白级别，取值范围0 - 9，0表示关闭，1 - 9值越大，效果越明显。
ruddiness：红润级别，取值范围0 - 9，0表示关闭，1 - 9值越大，效果越明显，该参数 Windows 平台暂未生效。
// 开启美颜trtcCloud.setBeautyStyle(TRTCBeautyStyle.TRTCBeautyStyleNature, 5, 5, 5);
步骤7：主播端创建房间并开始推流
1. 主播端设置 TRTCParams 中的字段
role为 **TRTCRoleType.TRTCRoleAnchor**，表示当前用户的角色为主播。2. 主播端调用 enterRoom( )即可创建 TRTCParams 参数字段
roomId 的值为房间号的音视频房间，并指定 appScene 参数：TRTCAppScene.TRTCAppSceneLIVE：视频互动直播，支持平滑上下麦，切换过程无需等待，主播延时小于300ms；支持十万级别观众同时播放，播放延时低至1000ms。本文以该模式为例。TRTCAppScene.TRTCAppSceneVoiceChatRoom：语音互动直播，支持平滑上下麦，切换过程无需等待，主播延时小于300ms；支持十万级别观众同时播放，播放延时低至1000ms。 关于
TRTCAppScene 的详细介绍，请参见 TRTCAppScene 。3. 房间创建成功后，主播端开始音视频数据的编码和传输流程。同时，SDK 会回调 onEnterRoom(result) 事件，参数
result 大于0时表示进房成功，具体数值为加入房间所消耗的时间，单位为毫秒（ms）；当 result 小于0时表示进房失败，具体数值为进房失败的错误码。let onEnterRoom = function (result) {if (result > 0) {console.log(`onEnterRoom，进房成功，使用了 ${result} 秒`);} else {console.warn(`onEnterRoom: 进房失败 ${result}`);}};trtcCloud.on('onEnterRoom', onEnterRoom);let param = new TRTCParams();param.sdkAppId = 1400000123;param.roomId = 29834;param.userId = 'test_user_001';param.userSig = 'eJyrVareCeYrSy1SslI...';param.role = TRTCRoleType.TRTCRoleAnchor;trtcCloud.enterRoom(param, TRTCAppScene.TRTCAppSceneLIVE);
步骤8：观众端进入房间观看直播
1. 观众端设置TRTCParams中的字段
role 为 **TRTCRoleType.TRTCRoleAudience**，表示当前用户的角色为观众。1. 观众端调用
enterRoom() 即可进入 TRTCParams 参数中 roomId 代指的音视频房间，并指定 appScene 参数：TRTCAppScene.TRTCAppSceneLIVE：视频互动直播。TRTCAppScene.TRTCAppSceneVoiceChatRoom：语音互动直播。2. 观看主播的画面：
如果观众端事先知道主播的
userId，直接在进房成功后使用主播 userId 调用 startRemoteView(userId, view) 即可显示主播的画面。如果观众端不知道主播的
userId，观众端在进房成功后会收到 onUserVideoAvailable() 事件通知，使用回调中获取的主播 userId 调用 startRemoteView(userId, view) 便可显示主播的画面。<div id="video-container"></div><script>const videoContainer = document.querySelector('#video-container');const roomId = 29834;// 进房回调，当进房成功时，会触发此回调let onEnterRoom = function(result) {if (result > 0) {console.log(`onEnterRoom，进房成功，使用了 ${result} 秒`);} else {console.warn(`onEnterRoom: 进房失败 ${result}`);}};// 当主播开启/关闭摄像头推流时，会触发此回调let onUserVideoAvailable = function(userId, available) {if (available === 1) {let id = `${userId}-${roomId}-${TRTCVideoStreamType.TRTCVideoStreamTypeBig}`;let view = document.getElementById(id);if (!view) {view = document.createElement('div');view.id = id;videoContainer.appendChild(view);}trtcCloud.startRemoteView(userId, view);trtcCloud.setRemoteViewFillMode(userId, TRTCVideoFillMode.TRTCVideoFillMode_Fill);} else {let id = `${userId}-${roomId}-${TRTCVideoStreamType.TRTCVideoStreamTypeBig}`;let view = document.getElementById(id);if (view) {videoContainer.removeChild(view);}}};trtcCloud.on('onEnterRoom', onEnterRoom);trtcCloud.on('onUserVideoAvailable', onUserVideoAvailable);let param = new TRTCParams();param.sdkAppId = 1400000123;param.roomId = roomId;param.userId = 'test_user_001';param.userSig = 'eJyrVareCeYrSy1SslI...';param.role = TRTCRoleType.TRTCRoleAudience; // 设置角色为“观众”trtcCloud.enterRoom(param, TRTCAppScene.TRTCAppSceneLIVE);</script>
步骤9：观众跟主播连麦
1. 观众端调用 switchRole(TRTCRoleType.TRTCRoleAnchor) 将角色切换为主播（
TRTCRoleType.TRTCRoleAnchor）。2. 观众端调用 startLocalPreview() 可以开启本地的画面。
3. 观众端调用 startLocalAudio() 开启麦克风采音。
//示例代码：观众上麦trtcCloud.switchRole(TRTCRoleType.TRTCRoleAnchor);trtcCloud.startLocalAudio();trtcCloud.startLocalPreview(frontCamera, view);//示例代码：观众下麦trtcCloud.switchRole(TRTCRoleType.TRTCRoleAudience);trtcCloud.stopLocalAudio();trtcCloud.stopLocalPreview();
步骤10：主播间进行跨房连麦 PK
TRTC 中两个不同音视频房间中的主播，可以在不退出原来的直播间的场景下，通过“跨房通话”功能拉通连麦通话功能进行“跨房连麦 PK”。
1. 主播 A 调用 connectOtherRoom() 接口，接口参数目前采用 JSON 格式，需要将主播 B 的
roomId和userId拼装成格式为{"roomId": 978,"userId": "userB"}的参数传递给接口函数。2. 跨房成功后，主播 A 会收到 onConnectOtherRoom(userId, errCode, errMsg) 事件回调。同时，两个直播房间里的所有用户均会收到 onUserVideoAvailable() 和 onUserAudioAvailable() 事件通知。
例如，当房间“001”中的主播 A 通过
connectOtherRoom()与房间“002”中的主播 B 拉通跨房通话后， 房间“001”中的用户会收到主播 B 的onUserVideoAvailable(B, true)回调和onUserAudioAvailable(B, true)回调。 房间“002”中的用户会收到主播 A 的onUserVideoAvailable(A, true) 回调和onUserAudioAvailable(A, true)回调。3. 两个房间里的用户通过调用 startRemoteView(userId, view) 即可显示另一房间里主播的画面，声音会自动播放。
//示例代码：跨房连麦 PKlet onConnectOtherRoom = function(userId, errCode, errMsg) {if(errCode === 0) {console.log(`成功连上主播 ${userId} 的房间`);} else {console.warn(`连接其他主播房间失败：${errMsg}`);}};const paramJson = '{"roomId": "978","userId": "userB"}';trtcCloud.connectOtherRoom(paramJson);trtcCloud.on('onConnectOtherRoom', onConnectOtherRoom);
步骤11：退出当前房间
// 调用退房后请等待 onExitRoom 事件回调let onExitRoom = function (reason) {console.log(`onExitRoom, reason: ${reason}`);};trtcCloud.exitRoom();trtcCloud.on('onExitRoom', onExitRoom);
注意：
如果您的 Electron 程序中同时集成了多个音视频 SDK，请在收到
onExitRoom回调后再启动其它音视频 SDK，否则可能会遇到硬件占用问题。文档反馈