本文档主要介绍如何进入 TRTC 房间中,只有在进入音视频房间后,用户才能订阅房间中其他用户的音视频流,或者向房间中的其他用户发布自己的音视频流。
请参考文档 导入 SDK 到项目中 完成 SDK 的导入工作。
import TRTCCloud from 'trtc-electron-sdk';
const rtcCloud = new TRTCCloud();
通过设置事件回调接口,您可以监听 SDK 在运行期间所发生的错误信息、警告信息、流量统计信息、网络质量信息以及各种音视频事件。
function onError(errCode, errMsg) {
// errorCode 可参考 https://www.tencentcloud.com/document/product/647/32257?from_cn_redirect=1#.E9.94.99.E8.AF.AF.E7.A0.81.E8.A1.A8
console.log(errCode, errMsg);
}
function onWarning(warningCode, warningMsg) {
// warningCode 可参考 https://www.tencentcloud.com/document/product/647/32257?from_cn_redirect=1#.E8.AD.A6.E5.91.8A.E7.A0.81.E8.A1.A8
console.log(warningCode, warningMsg);
}
rtcCloud.on('onError', onError);
rtcCloud.on('onWarning', onWarning);
在调用 enterRoom 接口时需要填写两个关键参数,即 TRTCParams
和 TRTCAppScene
,接下来进行详细介绍:
该参数用于指定您的应用场景,即在线直播还是实时通话:
TRTCAppSceneVideoCall
和 TRTCAppSceneAudioCall
两个可选项,分别是视频通话和语音通话,该模式适合 1对1 的音视频通话,或者参会人数在 300 人以内的在线会议。TRTCAppSceneLIVE
和 TRTCAppSceneVoiceChatRoom
两个可选项,分别是视频直播和语音直播,该模式适合十万人以内的在线直播场景,但需要您在接下来介绍的 TRTCParams 参数中指定 角色(role) 这个字段,也就是将房间中的用户区分为 主播(anchor) 和 观众(audience) 两种不同的角色。TRTCParams 由很多的字段构成,但通常您只需要关心如下几个字段的填写:
参数名称 | 字段含义 | 补充说明 | 数据类型 | 填写示例 |
---|---|---|---|---|
SDKAppID | 应用 ID | 您可以在 实时音视频控制台 中找到这个 SDKAppID,如果没有就单击“创建应用”按钮创建一个新的应用。 | 数字 | 1400000123 |
userId | 用户 ID | 即用户名,只允许包含大小写英文字母(a-z、A-Z)、数字(0-9)及下划线和连词符。注意 TRTC 不支持同一个 userId 在两台不同的设备上同时进入房间,否则会相互干扰。 | 字符串 | “denny” 或者 “123321” |
userSig | 进房鉴权票据 | 您可以使用 SDKAppID 和 userId 计算出 userSig,计算方法请参见 如何计算及使用 UserSig 。 | 字符串 | eJyrVareCeYrSy1SslI... |
roomId | 房间号 | 数字类型的房间号。注意如果您想使用字符串类型的房间号,请使用 strRoomId 字段,而不要使用 roomId 字段,因为 strRoomId 和 roomId 不可以混用。 | 数字 | 29834 |
strRoomId | 房间号 | 字符串类型的房间号。注意 strRoomId 和 roomId 不可以混用,“123” 和 123 在 TRTC 后台服务看来并不是同一个房间。 | 数字 | 29834 |
role | 角色 | 分为“主播”和“观众”两种角色,只有当 TRTCAppScene 被指定为 TRTCAppSceneLIVE 或 TRTCAppSceneVoiceChatRoom 这两种直播场景时才需要指定该字段。 |
枚举值 | TRTCRoleAnchor 或 TRTCRoleAudience |
注意:
- TRTC 不支持同一个 userId 在两台不同的设备上同时进入房间,否则会相互干扰。
- 每个端在应用场景 appScene 上必须要进行统一,否则会出现一些不可预料的问题。
在准备好 步骤4 中两个参数(TRTCAppScene 和 TRTCParams)后,就可以调用 enterRoom 接口函数进入房间了。
import { TRTCParams, TRTCRoleType, TRTCAppScene } from 'trtc-electron-sdk';
const param = new TRTCParams();
param.sdkAppId = 1400000123;
param.userId = "denny";
param.roomId = 123321;
param.userSig = "xxx";
param.role = TRTCRoleType.TRTCRoleAnchor;
// 如果您的场景是“在线直播”,请将应用场景设置为 TRTC_APP_SCENE_LIVE
rtcCloud.enterRoom(param, TRTCAppScene.TRTCAppSceneLIVE);
事件回调:
result
会是一个负数,其数值为进房失败的错误码。function onEnterRoom(result) {
// onEnterRoom 参见 https://web.sdk.qcloud.com/trtc/electron/doc/zh-cn/trtc_electron_sdk/TRTCCallback.html#event:onEnterRoom
if (result > 0) {
console.log('Enter room succeed');
} else {
// 参见进房错误码 https://www.tencentcloud.com/document/product/647/35124
console.log('Enter room failed');
}
}
rtcCloud.on('onEnterRoom', onEnterRoom);
本页内容是否解决了您的问题?