RTC Engine
  • Overview
  • Web
    • Demo のクイックスタート
    • SDK クイックスタート
    • 基本機能
      • 画面共有
      • ライブブロードキャスト
      • メディアデバイス
      • 音量
      • エンコーディング構成ファイルの設定
      • ネットワーク品質の検出
      • 検出能力
    • 高度な機能
      • AI ノイズ低減の有効化
      • ミキシングを有効にします
      • ウォーターマークを有効にします
      • Enable Virtual Background
      • 美顔とエフェクトの有効化
      • データメッセージ
      • キャプチャーとレンタリングのカスタマイズ
    • インターフェースリスト
    • リリース説明
    • 対応するプラットホーム
    • Web に関するよくあるご質問
      • 複数人でのビデオ通話を最適化
      • 制限付き自動再生の処理
      • ファイアウォール制限への対応
      • その他
  • Android
    • Run Sample Code
    • Integration
    • インテグレーション
      • 7. ネットワーク品質の検出
      • 8. 画面共有の有効化
      • 9. ビデオ品質の設定
      • 10. ビデオの回転
    • Advanced Features
      • ネットワーク品質のテスト
      • キャプチャーとレンタリングのカスタマイズ
      • オーディオキャプチャーと再生のカスタマイズ
    • 顧客インターフェース
      • Overview
      • TRTCCloud
      • TRTCStatistics
      • TRTCCloudListener
      • TXAudioEffectManager
      • TXBeautyManager
      • TXDeviceManager
      • タイプ定義
      • 廃棄インタフェース
      • エラーコード
    • ソリューション
      • リアルタイムコーラス (TUIKaraoke)
        • クイックインテグレーション
        • 実施ステップ
        • 曲の同期
        • 歌詞の同期
        • 音声同期
        • ミクスストリーミングソリューション
        • TRTCKaraoke 関連インターフェース
        • よくあるご質問
    • リリース説明
  • iOS
    • Run Sample Code
    • Integration
    • インテグレーション
      • 7. ネットワーク品質の検出
      • 8. 画面共有の有効化
      • 9. ビデオ品質の設定
      • 10. ビデオの回転
    • Advanced Features
      • ネットワーク品質のテスト
      • キャプチャーとレンタリングのカスタマイズ
      • オーディオキャプチャーと再生のカスタマイズ
    • 顧客インターフェース
      • Overview
      • TRTCCloud
      • TRTCCloudDelegate
      • TRTCStatistics
      • TXAudioEffectManager
      • TXBeautyManager
      • TXDeviceManager
      • タイプ定義
      • 廃棄インタフェース
      • ErrorCode
    • ソリューション
      • クイックインテグレーション
      • 実施ステップ
      • 曲の同期
      • 歌詞の同期
      • 音声同期
      • ミクスストリーミングソリューション
      • TRTCKaraoke 関連インターフェース
      • よくあるご質問
    • リリース説明
  • macOS
    • Run Sample Code
    • Integration
    • インテグレーション
      • 7. ネットワーク品質の検出
      • 8. 画面共有の有効化
      • 9. パソコンサウンドの共有
      • 10. ビデオ品質の設定
      • 11. ビデオの回転
    • Advanced Features
      • ハードウェアデバイスのテスト
      • ネットワーク品質のテスト
      • キャプチャーとレンタリングのカスタマイズ
      • オーディオキャプチャーと再生のカスタマイズ
    • 顧客インターフェース
      • Overview
      • TRTCCloud
      • TRTCCloudDelegate
      • TRTCStatistics
      • TXAudioEffectManager
      • TXBeautyManager
      • TXDeviceManager
      • タイプ定義
      • 廃棄インタフェース
      • ErrorCode
      • リリース説明
    • リリース説明
  • Windows
    • Run Sample Code
    • Integration
    • インテグレーション
      • 7. ネットワーク品質の検出
      • 8. 画面共有の有効化
      • 9. ビデオ品質の設定
      • 10. ビデオの回転
    • Advanced Features
      • ハードウェアデバイスのテスト
      • ネットワーク品質のテスト
      • キャプチャーとレンタリングのカスタマイズ
      • オーディオキャプチャーと再生のカスタマイズ
    • 顧客インターフェース
      • Overview
      • ITRTCCloud
      • ITRTCStatistics
      • TRTCCloudCallback
      • ITXAudioEffectManager
      • ITXDeviceManager
      • タイプ定義
      • 廃棄インタフェース
      • エラーコード
    • リリース説明
  • Electron
    • インテグレーション
      • 1. インターフェースの例
      • 2. SDK のインポート
      • 3. ルームに入る
      • 4. オーディオ・ビデオストリームのサブスクリプション
      • 5. オーディオ・ビデオストリームのリリース
      • 6. ルームからの退出
      • 7. ネットワーク品質の検出
      • 8. 画面共有の有効化
      • 9. パソコンサウンドの共有
      • 10. ビデオ品質の設定
      • 11. ビデオの回転
    • 顧客インターフェース
      • Overview
      • エラーコード
  • Flutter
    • インテグレーション
      • 1. インターフェースの例
      • 2. SDK のインポート
      • 3. ルームに入る
      • 4. オーディオ・ビデオストリームのサブスクリプション
      • 5. オーディオ・ビデオストリームのリリース
      • 6. ルームからの退出
      • 7. ネットワーク品質の検出
      • 8. 画面共有の有効化
      • 9. パソコンサウンドの共有
      • 10. ビデオ品質の設定
      • 11. ビデオの回転
    • 顧客インターフェース
      • Overview
      • エラーコード
  • Unity
    • インテグレーション
      • 1. インターフェースの例
      • 2. SDK のインポート
    • 顧客インターフェース
      • Overview
      • エラーコード
  • QT
    • インテグレーション
      • 1. SDK のインポート
  • Overview
    • Overview
  • 概念
  • Features
  • 性能統計
  • 価格
    • 無料時間
    • RTC-Engine パッケージ
    • サブスクリプションパッケージ期間の課金説明
    • 従量課金
      • 音声・ビデオ時間の課金説明
      • クラウド録画の課金説明
      • ミックストランスコーディングとCDNへのリレーの課金説明
  • よくあるご質問
    • 初心者のよくあるご質問
    • マイグレーションガイド
      • Twilio Video から TRTC への移行
      • 課金
      • Features
      • UserSig
      • ファイアウォール制限
      • インストールパッケージを削減する方法
      • TRTCCalling Web 関連
      • オーディオ・ビデオの品質
      • その他
RTC Engine

概念

ここでは、Tencent Real-Time Communication(TRTC)のサービスのご利用中に触れる可能性のある基本概念についてご説明します。

アプリケーション

TRTCではアプリケーション形式で様々な業務やプロジェクトを管理します。TRTCコンソールで業務やプロジェクトごとに、それぞれのアプリケーションを作成することで、業務やプロジェクトのデータの隔離を実装することができます。1つのTencent Cloudアカウントにつき、最大100のTRTCアプリケーションが作成可能です。

SDKAppID

SDKAppID(アプリケーション識別子/アプリケーションID)は、Tencent Cloudのバックエンドで様々なTRTCアプリケーションを識別するために用いる固有の識別子であり、TRTC コンソールでアプリケーションを作成すると自動的に生成されます。異なるSDKAppID間では、データは相互運用されません。

UserID

UserID(ユーザーID)は、1つのTRTCアプリケーションでユーザーを固有に識別するために用いられます。
ユーザーIDは、ユーザーが開発者の業務システムにログインするアカウントをTencent Cloudにマッピングしたものです。通常、開発者は利用ユーザー名をUserIDとしてそのまま使用できます。
値の範囲の長さは32バイト以下にすることを推奨します。英字、数字またはアンダーバーを使用してください。大文字小文字は区別されます。

ルーム

ルームは、1つのオーディオ・ビデオ空間であり、同じルーム内のユーザーは、互いに相手のTRTCのデータを受信することができます。
TRTCは、ユーザー間の相互隔離のためにルームという仮想化の概念を使用します。
同じルーム内のユーザーだけがオーディオ・ビデオを相互に受信することができます。
1人のユーザーは、一度に1つのルームにしか参加できません。他のルームに参加したい場合は、前のルームから退出する必要があります。
ご注意:
ルームに最初に参加したユーザーがそのルームのオーナーとなりますが、このユーザーが自主的にルームを解散することはできません。
通話モードの場合:すべてのユーザーが自主的に退室したときは、バックエンドでルームが速やかに解散されます。
ライブストリーミングモードの場合:最後に退室したユーザーがキャスターロールの場合、バックエンドでルームが速やかに解散されます。最後に退室したユーザーが視聴者ロールの場合、バックエンドで10分間待ってからルームが解散されます。
ルーム内の1人のユーザーの接続が異常により切断された場合、90秒後にサーバーがこのユーザーを現在のルームから消去します。ルーム内のすべてのユーザーの接続が異常に切断された場合、90秒後にサーバーが現在のルームを自動的に解散します。ユーザーの接続が異常により切断された場合の待機時間は課金時間の集計に含まれます。
ユーザーが参加したいルームが存在しない場合、TRTCのバックエンドで自動的にルームが作成されます。

RoomID

RoomID(ルームナンバー/ルームID)は、TRTCアプリケーションでルームを固有に識別するために用いられます。RoomIDは、開発者自らによって維持され割り当てられるuint32範囲内の数字であり、数値は、1~4294967295となります。

UserSig

UserSi(ユーザー署名)とは、Tencent Cloudが設計したセキュリティ保護署名であり、ユーザーのログインと認証に用いられ、正しいユーザーかどうかを確認し、悪意ある攻撃者がお客様のクラウドサービス使用権限を盗用するのを防止します。詳細については、UserSigに関するご質問をご参照ください。

プッシュ

プッシュとは、ユーザーがローカルのオーディオ・ビデオデータをTRTCサーバーにアップロードする操作をいい、これは「プッシュストリーム」に対応します。

サブスクリプション

サブスクリプションとは、ユーザーがTRTCサーバーに対し、指定されたユーザーのオーディオ・ビデオデータのプルをリクエストする操作をいい、これは「プルストリーム」に対応します。

ロール

TRTCは、キャスター(TRTCRoleAnchor)と視聴者(TRTCRoleAudience)という2つのロールをサポートしています。2つの違いは次のとおりです。
キャスターロールでは、サーバーに自らのオーディオ・ビデオデータをプッシュするだけでなく、サーバーから他のキャスターロールのオーディオ・ビデオデータをサブスクリプションし、再生する機能もサポートしています。
視聴者ロールは、サーバーからキャスターロールのオーディオ・ビデオデータをサブスクリプションし、再生する機能のみをサポートしています。
通話モードでは、ルームに参加したすべてのユーザーがキャスターロールとなります。ライブストリーミングモードでは、実際の業務シーンに応じて、ルームに参加したユーザーをキャスターと視聴者という2つのロールに分けることができ、同じユーザーでもいつでもロールを切り替えることが可能です。

CDN relayed live streaming

CDNライブストリーミング、別名「CDN relayed live streaming」といいます。TRTCはクラウド上でバイパストランスコードクラスターを使用して、TRTCが使用したUDPプロトコルを標準のライブストリーミングRTMPプロトコルに変換し、TRTCのオーディオ・ビデオデータを標準のLive Video Broadcasting(CSS)システムにプッシュしてから、CDN経由で配信します。これによって、CDN relayed live streamingを実装します。詳細については、CDN relayed live streamingの実装をご参照ください。

クラウドレコーディング

TRTCではRelayed Pushの方式を採用しCSSの機能を利用して、トータルなクラウドレコーディング機能(録音/録画)を提供します。さらにレコーディングしたファイルをVODのプラットフォームに保存して、レコーディングプロセスの信頼性と即時性を確保します。詳細については、クラウドレコーディングと再生をご参照ください。

Cloud MixTranscoding

CDN relayed live streamingクラウドレコーディングなどのユースケースでは、TRTCルームにおける複数のオーディオ・ビデオストリーミングを1つのチャネルにミックスする必要がある場合があります。TRTCクラウドサービスのバックグラウンドにあるMCUミクスストリーミングトランスコードクラスターによって、この作業を完了することができます。MCUクラスターは、複数のオーディオ・ビデオストリーミングを必要に応じてミックスし、最終的に生成されたビデオストリームをライブCDNとクラウドレコーディングシステムに配信することができます。詳細については、Cloud MixTranscodingをご参照ください。

ダム端末

ダム端末で視聴者が入室しストリームをプルした場合、他のSDKからは認識されません(ダム端末の入退室イベント通知はリモートで受信できません)。