tencent cloud

ここでは主に、TRTCルームへの入室方法についてご説明します。オーディオビデオルームに入室すると、ユーザーはルーム内の他のユーザーのオーディオビデオストリーミングをサブスクリプションしたり、ルーム内の他のユーザーに自分のオーディオビデオストリーミングを公開したりすることができます。

呼び出しガイド

ステップ1：SDKのインポート

ドキュメントSDKのプロジェクトへのインポートを参照し、SDKのインポートを完了してください。

ステップ2： SDKインスタンスの作成

import TRTCCloud from 'trtc-electron-sdk';
const rtcCloud = new TRTCCloud();

ステップ3：SDKイベントの監視

イベントコールバックインターフェースを設定することで、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);

ステップ4：入室パラメータTRTCParamsの準備

enterRoomインターフェースを呼び出す際には、TRTCParamsとTRTCAppSceneという2つのキーパラメータを入力する必要があります。次に詳しくご説明します。

パラメータ1：TRTCAppScene

このパラメータは、お客様のユースケース、すなわちオンラインライブストリーミングまたはリアルタイム通話を指定するために使用します。

• リアルタイム通話：ビデオ通話用のTRTCAppSceneVideoCallと音声通話用のTRTCAppSceneAudioCallという2つのオプションがあります。このモードは、1対1のオーディオビデオ通話や参加者300人以内のオンラインミーティングに適しています。
• オンラインライブストリーミング：ビデオライブストリーミング用のTRTCAppSceneLIVEと音声ライブストリーミング用のTRTCAppSceneVoiceChatRoomという2つのオプションがあります。このモードは、最大10万人規模のライブストリーミングシナリオに適していますが、次にご紹介するTRTCParamsパラメータにロール(role)**というフィールドを指定する必要があります。これは、ルーム内のユーザーがキャスター(anchor)と視聴者(audience)**という2つのロールに区別されることを意味します。

パラメータ2：TRTCParams

TRTCParamsはたくさんのフィールドから構成されていますが、通常は、以下のフィールドについてのみ入力する必要があります。

注意：

• TRTCは、同じuserIdによる2つの異なるデバイスの同時入室をサポートしていません。同時に入室した場合は相互に干渉します。
• 各端末のユースケースappSceneについては、統一する必要があります。統一していない場合、想定外のトラブルが生じる恐れがあります。

ステップ5：入室(enterRoom)

ステップ4で2つのパラメータ（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);

イベントコールバック：

• 入室に成功すると、SDKはonEnterRoom(result)イベントをコールバックします。そのうちresultは0以上の値で、入室にかかった時間をミリ秒(ms)単位で表します。
• 入室に失敗した場合、SDKはonEnterRoom(result)イベントをコールバックしますが、パラメータ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);