- お知らせ・リリースノート
- 製品の説明
- 購入ガイド
- 初心者ガイド
- Demo体験
- Video Calling (Including UI)
- UIを含まない統合ソリューション
- 高度な機能
- サーバー側 API
- コンソールガイド
- Solution
- よくあるご質問
- 旧バージョンのドキュメント
- Protocols and Policies
- TRTC ポリシー
- 用語集
- お知らせ・リリースノート
- 製品の説明
- 購入ガイド
- 初心者ガイド
- Demo体験
- Video Calling (Including UI)
- UIを含まない統合ソリューション
- 高度な機能
- サーバー側 API
- コンソールガイド
- Solution
- よくあるご質問
- 旧バージョンのドキュメント
- Protocols and Policies
- TRTC ポリシー
- 用語集
TRTCのRoomIDとは何ですか。指定できる値の区間はいくつですか。
RoomID、即ちルームナンバーは、1つのルームを一意的に示すために利用します。ルームナンバーの値の範囲は、1～4294967295です。開発者が自主的にメンテナンスとアサインを行います。
TRTCのルーム参加UserIDとは何ですか。指定できる値の範囲はいくつですか。
UserID、即ちユーザーIDは、1つのTRTCアプリケーションの中で、1人のユーザーを一意的に示すために利用します。長さは32バイト以下にすることを推奨します。英字、数字またはアンダーバーを使用してください。大文字小文字は区別されます。
TRTCのルームのライフサイクルはどのくらいですか。
ルームに最初に参加したユーザーがそのルームのオーナーとなりますが、このユーザーが自主的にルームを解散することはできません。
通話モードの場合：すべてのユーザーが自主的に退室したときは、バックエンドでルームが速やかに解散されます。
ライブストリーミングモードの場合：最後に退室したユーザーがキャスターロールの場合、バックエンドでルームが速やかに解散されます。最後に退室したユーザーが視聴者ロールの場合、バックエンドで10分間待ってからルームが解散されます。
ルーム内の1人のユーザーの接続が異常により切断された場合、90秒後にサーバーがこのユーザーを現在のルームから消去します。ルーム内のすべてのユーザーの接続が異常に切断された場合、90秒後にサーバーが現在のルームを自動的に解散します。ユーザーの接続が異常により切断された場合の待機時間は課金時間の集計に含まれます。
ユーザーが参加したいルームが存在しない時は、バックエンドで1つのルームを自動作成します。
TRTCではサブスクリプトしないオーディオビデオストリーミングをサポートしていますか。
「秒速開始」効果を実現するため、デフォルトでは、ルームに参加すると自動サブスクリプトに設定されています。setDefaultStreamRecvModeのインターフェースで、手動サブスクリトモードに切り替えることが可能です。
TRTCでは、Relayed PushのストリームIDのカスタマイズをサポートしていますか。
サポートしています。enterRoomのパラメータTRTCParamsでstreamIdを指定することも、startPublishingインターフェースを呼び出して、パラメータにstreamIdを渡すことも可能です。
TRTCライブストリーミングはどのようなロールをサポートしていますか。ロールの違いは何ですか。
ライブストリーミングのシーン（TRTCAppSceneLIVEとTRTCAppSceneVoiceChatRoom）は、TRTCRoleAnchor（キャスター）とTRTCRoleAudience（視聴者）という2つのロールをサポートしています。違いとしては、キャスターのロールはオーディオ・ビデオデータのアップロードとダウンロードを同時に行うことができますが、視聴者のロールは他人のデータのダウンロードと再生のみをサポートしていることです。switchRole() を呼び出すことにより、ロールを切り替えることができます。
TRTCのRoleはどう理解すればいいですか。
ライブストリーミングのシーンでのみ、キャスターと視聴者のロールを設定できます。キャスターのロール TRTCRoleAnchorは オーディオ・ビデオのアップストリーム、ダウンストリームの権限をもち、最大で同時に50人をサポートしています。視聴者TRTCRoleAudienceは、オーディオ・ビデオのダウンストリームの権限しかもちませんが、最大で同時に最大10万人をサポートしています。
TRTCのルームではどのようなユースケースをサポートしていますか。
以下のシーンをサポートしています。
TRTCAppSceneVideoCall ：ビデオ通話シーン。1対1のビデオ通話、300人のビデオミーティング、オンライン診察、ビデオチャット、リモート面接などに適しています。
TRTCAppSceneLIVE ：ビデオ・インタラクティブストリーミング。低遅延のビデオライブストリーミング、10万人の双方向対話型クラス、ビデオライブストリーミングのPK、ビデオお見合い、双方向対話型クラス、リモートトレーニング、超大型ミーティングなどに適しています。
TRTCAppSceneAudioCall ：音声通話シーン。1対1の音声通話、300人の音声ミーティング、音声チャット、音声ミーティング、オンライン版人狼ゲームなどに適しています。
TRTCAppSceneVoiceChatRoom：ボイス・インタラクティブストリーミング。低遅延の音声ライブストリーミング、音声ライブストリーミングのマイク接続、音声チャットルーム、カラオケ、FMラジオなどに適しています。
TRTCはどのプラットフォームをサポートしますか。
TRTC簡易版と全機能版の違いは何ですか。
TRTCではライブストリーミングのマイク接続をサポートしていますか。
サポートしています。具体的な操作ガイドは以下をご参照ください。
TRTCではルームを同時にいくつ作成できますか。
4,294,967,294室のルームの同時併存をサポートします。ルームの累計数は無制限です。
ルームはどうやって作成しますか。
ルームは、Tencent Cloudのバックエンドがクライアントのルーム参加時に自動作成します。お客様は、手動でルームを作成する必要がなく、クライアントの関連インターフェースを呼び出して「ルームに参加」するだけで済みます。
Windows(C++) > enterRoom
TRTCのビデオサーバーがサポートする帯域幅は最大でいくつですか。
制限はありません。
TRTCはプライベート化したデプロイをサポートしていますか。
TRTCのプライベート化したデプロイは、まだ完全にはリリースされていません。プライベート化サービスについて、お問い合わせまたはご利用を希望される場合は、colleenyu@tencent.comまでご連絡ください。
プライベートクライアントの制限事項：ネイティブSDK(iOS、Mac、Android、Windows)はサポートされていますが、WebRTC、ミニプログラムはサポートされていません。
TRTCでRelayed live streamingをアクティブ化した場合、利用にはドメイン名のICP登録が必要ですか。
Relayed live streamingをアクティブ化する必要がある場合は、国の関連部門の要件に基づき、再生ドメイン名のICP登録をしないと使用できません。
TRTCの遅延はどのくらいですか。
グローバルなエンドツーエンドの平均遅延は300ms未満です。
TRTCは主動的な呼出機能をサポートしていますか。
シグナリングチャネルのソリューションを結合させる必要があります。例えば IMのサービスのカスタムメッセージを利用して、呼び出しを実現します。SDKのソースコードの中のシナリオ化Demoの例をご参照ください。
TRTCの2人用ビデオ通話では、Bluetoothのイヤホンをサポートしていますか。
サポートしています。
TRTCのPCアクセスポートは画面共有機能をサポートしていますか。
サポートしています。次のドキュメントをご参照ください。
ローカルのビデオファイルをTRTCの中で共有する機能をサポートしていますか。
TRTCでは、ライブストリーミングでレコーディングしたビデオを、ローカルの携帯電話に保存することはできますか。
ローカルの携帯電話への直接保存はサポートしていません。レコーディング後は、ビデオファイルはデフォルトでVODプラットフォームに保存されますので、ご自分でダウンロードして携帯電話に保存できます。
TRTCでは単純な音声だけのRTCもサポートしていますか。
音声だけもサポートしています。
1つのルームで同時にいくつの画面を共有できますか。
現在、1つのルームで共有できるのはサブストリームの画面1つのみです。
ウィンドウの共有（SourceTypeWindow）を指定し、ウィンドウのサイズが変化した場合は、ビデオストリームの解像度も変化しますか。
デフォルトでは、SDK内で共有ウィンドウのサイズに従ってエンコーディングパラメータを自動的に調整します。
解像度を固定する必要がある場合は、setSubStreamEncoderParamインターフェースを呼び出し画面共有のエンコーディングパラメータを設定するか、またはstartScreenCaptureを呼び出すときに、対応するエンコーディングパラメータを指定する必要があります。
TRTCでは1080Pをサポートしていますか。
サポートしています。SDKのビデオコーデックパラメータsetVideoEncoderParamで、解像度を設定できます。
TRTCではデータキャプチャのカスタマイズが可能ですか。
TRTCは、インタラクティブライブSDKと通信できますか。
できません。
TRTCは、モバイルライブストリーミングと通信できますか。
TRTCとモバイルライブストリーミングはバックグラウンド方式のアーキテクチャが異なりますので、直接的な相互通信はサポートされていません。TRTCのバックグラウンドからCDNに向けてRelayed Pushすることのみ可能です。
TRTCのルーム参加モードAppSceneにはどのような区別がありますか。
TRTCは、4種類の異なる入室モードをサポートしています。このうち、ビデオ通話（VideoCall）および音声通話（VoiceCall）を総称して通話モードといい、ビデオ・インタラクティブストリーミング（Live）およびボイス・インタラクティブストリーミング（VoiceChatRoom）を総称してライブストリーミングモードといいます。
通話モードでのTRTCは、1つのルームに最大で300人の同時オンラインをサポートし最大で50人の同時発言をサポートします。1対1のビデオ通話、300人のビデオミーティング、オンライン問診、リモート面接、ビデオカスタマーサービス、オンライン人狼ゲームなどのユースケースに適合しています。
ライブストリーミングモードでのTRTCは、1つのルームで最大10万人の同時接続をサポートし、300ms未満のマイク接続遅延、1000ms未満の視聴遅延およびマイクのオン・オフのスムーズな切り替え技術を備えています。低レイテンシーインタラクティブライブストリーミング、10万人のインタラクティブ教室、ビデオ婚活、eラーニング、リモート研修、超大規模ミーティングなどのユースケースに適しています。
TRTCではオーディオビデオ通話のハンズフリーモードをサポートしていますか。
サポートしています。ハンズフリーモードは、Audio Routerを設定することで実現できます。Native SDKでは、setAudioRouteインターフェースで切り替えます。
TRTCでは音量のボリューム表示をサポートしていますか。
サポートしています。enableAudioVolumeEvaluationインターフェースから起動できます。
TRTCではミラーリング画面の設定をサポートしていますか。
サポートしています。setLocalViewMirrorインターフェースでローカルカメラのプレビュー画面をミラーリングモードに設定するか、またはsetVideoEncoderMirrorインターフェースでエンコーダが出力する画面をミラーリングモードに設定します。
TRTCでは、通話プロセスの音声をローカルファイルにレコーディングする機能をサポートしていますか。
サポートしています。startAudioRecordingインターフェースで通話プロセスの全ての音声（ローカル音声、リモート音声、BGMなど）を1つのファイルにレコーディングできます。現在サポートしている音声ファイル形式はPCM、WAV、AACです。
TRTCでは、インタラクティブな音声ビデオ通信のプロセスのビデオをファイルにレコーディングする機能をサポートしていますか。
自社サーバーでのレコーディング（録音/録画）をサポートしています。ご利用を希望される場合は、チケットを提出 からお問い合わせいただき、SDKおよび関連ガイドを入手してください。
「クラウドレコーディングと再生の実現」を使用してビデオをレコーディングすることもできます。
TRTCでは、WeChatのビデオ通話のようなフローティングウィンドウ、大小画面の切り替え等の機能をサポートしていますか。
こういった機能はUIのレイアウトロジックに属しますが、SDKにUIのディスプレイ処理の制限はありません。公式Demoの中では、画面前後のスタックと9分割グリッドのレイアウトモードのサンプルコードを提供し、フローティングウィンドウ、大小画面切り替え、画面ドラッグなどの機能もサポートしています。より詳しい情報は、公式Demoをご参照ください。
TRTCで純音声通話を実現させるにはどうすればいいですか。
TRTCには音声チャネルとビデオチャネルの区別はありません。startLocalAudioを呼び出し、startLocalPreview を呼び出さなければ、純音声通話モードになります。
TRTCの純音声通話でRelayed Pushとレコーディングを実現するにはどうすればいいですか。
6.9以前のバージョンの場合、ルーム参加時に
json{\\"Str_uc_params\\":{\\"pure_audio_push_mod\\":1}}と記述し、 TRTCParams.businessInfoに送る必要があります。1はRelayed Push、2はRelayed Push+レコーディングを表します。TRTC SDK 6.9以降のバージョンでは、ルーム参加時にシーンのパラメータでTRTCAppSceneAudioCallまたは TRTCAppSceneVoiceChatRoomを選択すれば実現できます。
TRTCルームは、キックアウト、発言の禁止、ミュートをサポートしていますか。
サポートしています。
簡単なシグナリング操作の場合、TRTCのカスタムシグナルインターフェースsendCustomCmdMsgを使用できます。開発者が対応する制御シグナリングをカスタマイズして、制御シグナリングを受信した通話者が対応する操作を実行すればOKです。例えば、キックアウトとは、追い出しシグナリングを定義することであり、この信号を受信したユーザーは自動的に退室します。
より完全な操作ロジックを実行する必要がある場合は、開発者が[IM]（https://www.tencentcloud.com/document/product/1047）を使用して関連のロジックを実行し、TRTCルームとIMグループとのマッピングを行い、IMグループでカスタムメッセージを送受信して、対応する操作を実行することをお勧めします。
TRTCでは、プルされたRTMP/FLV形式のストリーミング再生をサポートしていますか。
サポートしています。現在すでにTRTC SDKの中に TXLivePlayerがパッケージングされています。より多くのプレーヤー機能が必要な場合は、LiteAVSDK_Professionalバージョンを直接使用すれば、すべての機能が含まれています。
TRTCは最大何人の同時通話をサポートできますか。
通話モードでは、1ルームあたり最大300人の同時接続、最大50人のカメラまたはマイクの同時使用をサポートしています。
ライブストリーミングモードでは、1ルームあたり視聴者10万人のオンライン視聴と、キャスター50人のカメラまたはマイクの使用をサポートしています。
TRTCはライブストリーミングのシーン類のアプリケーションをどのように実現しますか。
TRTCは、特にオンラインライブストリーミングのシーン向けに、10万人向けの低遅延インタラクティブライブストリーミングソリューションをリリースしました。これにより、キャスターとマイク接続したキャスター間の最小遅延が200ms、通常の視聴者の遅延が1秒以内になるだけでなく、脆弱なネットワークに極めて高い耐性を持つこととなり、モバイル端末の複雑なネットワーク環境に対応します。
具体的な操作ガイドについては、ライブストリーミングクイックスタートモードをご参照ください。
TRTCのカスタムメッセージ送信のインターフェースを利用して、チャットルーム、弾幕等の機能を実現できますか。
TRTC SDKのBGM再生では、繰り返し再生をサポートしていますか。BGM再生の進行状況を調整する機能をサポートしていますか。
サポートしています。繰り返し再生は完了コールバック中に再度呼び出して再生します。再生の進捗はTXAudioEffectManager seekMusicToPosInMSによって設定できます。
説明：
setBGMPosition() はv7.3 バージョンで廃止されています。 TXAudioEffectManager seekMusicToPosInMSに切り替わっています。
TRTCにはルームメンバーのルーム入退室をモニタリングするコールバックがありますか。onUserEnter/onUserExitを使用できますか。
あります。TRTCでは onRemoteUserEnterRoom/onRemoteUserLeaveRoom を使用してルームメンバーのルーム入退出を監視しています（アップストリームオーディオ・ビデオ権限があるユーザーのみ起動できます）。
説明：
onUserEnter/onUserExitは6.8バージョンで廃止され、onRemoteUserEnterRoom/onRemoteUserLeaveRoom経由に切り替わっています。
TRTCでは回線の切断と再接続をどのようにモニタリングしますか。
以下のコールバックのモニタリングによって行います。
onConnectionLost：SDKとサーバーの間の接続が切断。
onTryToReconnect：SDKがサーバーへの再接続を試行。
onConnectionRecovery：SDKとサーバー間の接続回復。
TRTC SDKは切断後の再接続をサポートしていますか。
SDKは、ユーザーが切断されたときの自動再接続をサポートしています（30分間再接続が成功しなかった場合は、自動的に退室になり、エラーコード-3301が返されます）。接続中における具体的な接続状態や接続時の処理ロジックは、以下のとおりです。下図はUserid1がチャネルに参加してから、接続が中断し、再びルームに参加する過程で受信したモニタリングコールバックイベントを示しています。
T1：ユーザー側が
enterRoomインターフェースを呼び出し、ルーム参加リクエストを送信します。T2：ユーザーであるUserid1は、
onEnterRoomコールバックを受信し、Userid2はUserid1の遅延を感知し、約300ms後にUserid2はonRemoteUserEnterRoomコールバックを受信します。T3：Userid1のクライアントがネットワークの問題で切断された場合、SDKがルームへの再参加を試みます。
T4：Userid1が8秒以内にサーバーへの接続が確立しなかった場合、
onConnectionLost切断コールバックを受信します。T5：Userid1は3秒経ってもサーバーへの接続が確立しなかった場合、
onTryToReconnectリトライコールバックを受信します。T6：Userid1は24秒ごとに、onTryToReconnectリトライコールバックを受信します。
T7：Userid2がUserid1から切断通知を受信してから90秒後、SDKはリモートユーザーUserid1が切断されたと判断します。Userid2は
onRemoteUserLeaveRoomコールバックを受信します。T8：Userid1が切断中の任意の時点で再接続に成功した場合、
onConnectionRecoveryリカバリコールバックを受信します。TRTCには最初のフレームのレンダリングのコールバックはありますか。画面のレンダリング開始、音声の再生開始のモニタリングはできますか。
サポートしています。onFirstVideoFrame/onFirstAudioFrameでモニタリングできます。
TRTCではビデオ画面のスクリーンキャプチャ機能をサポートしていますか。
現在iOS/Android端末では、snapshotVideo() を呼び出すことで、ローカルおよびリモートのビデオ画面スクリーンキャプチャをサポートしています。
TRTCではBluetoothイヤホン等の外付けデバイスとの接続に異常はありますか。
現在、TRTCでは主流のBluetoothイヤホンや外付けデバイスとは互換性がありますが、それでも互換性に問題のあるデバイスに遭遇することがあり得ます。公式DemoやQQのオーディオビデオ通話の比較を利用し、正常かどうか確認することをお勧めします。
TRTCのオーディオ・ビデオのプロセスでのアップストリーム、ダウンストリームのビットレート、解像度、パケット損失率、オーディオサンプルレート等の情報はどうすれば取得できますか。
SDKのインターフェースonStatistics()でこれらの統計情報を取得できます。
TRTCのBGM再生インターフェースplayBGM() はオンラインミュージックをサポートしていますか。
現在はローカルの音楽のみサポートしています。先にローカルにダウンロードしてから、playBGM()を呼び出して再生することが可能です。
TRTCではローカルでキャプチャする音量の設定機能をサポートしていますか。各リモートユーザーの再生音量の設定機能をサポートしていますか。
サポートしています。setAudioCaptureVolume() インターフェースでSDKのキャプチャ音量を設定可能です。また、setRemoteAudioVolume()インターフェースで特定のリモートユーザーの再生音量を設定できます。
stopLocalPreviewとmuteLocalVideoの違いは何ですか。
stopLocalPreviewは、ローカルでのビデオキャプチャを停止します。このインターフェースを呼び出すと、自らのローカルとリモートの画面をブラックアウトさせます。
muteLocalVideoは、バックグラウンドに向けて自らのビデオ画面を送信するかを設定します。このインターフェースを呼び出すと、他のユーザーが視聴していた画面はブラックアウトしますが、自らのローカルのプレビュー画面はまだ見ることができます。
stopLocalAudioとmuteLocalAudioの違いは何ですか。
stopLocalAudioは、ローカル音声のキャプチャとアップストリームをオフにします。
muteLocalAudioでは、音声・ビデオデータの送信は停止されず、ビットレートが極めて低いミュートパケットが引き続き送信されます。
TRTC SDKではどの解像度をサポートしていますか。
TRTC SDKではアップストリームのビデオビットレート、解像度、フレームレートをどのように設定しますか。
TRTCCloudのsetVideoEncoderParam()インターフェースで、TRTCVideoEncParamパラメータの中のvideoResolution（解像度）、videoFps（フレームレート）、videoBitrate（ビットレート）を設定できます。
SDKの画面の角度と方向の制御はどうすれば実現できますか。
横長画面のビデオ通話はどうすれば実現できますか。
TRTCでローカルとリモートの画面方向が一致しない場合はどうやって調整しますか。
TRTC には推奨する画質（ビットレート、解像度、フレームレート）関連のパラメータ設定はありますか。
TRTCではネットワークの速度テストをサポートしていますか。どうやって操作しますか。
TRTCではルームに対する権限の検証をサポートしていますか（例：検証に合格してから会員がシーンに参加できるなど）。
TRTCオーディオビデオストリーミングは、CDNを介したプルストリームによる視聴をサポートしていますか。
サポートしています。
TRTCのカスタムレンダリングはどの形式をサポートしていますか。
iOS端末ではi420、NV12、BGRAをサポートしています。
Android端末ではI420とtexture2dをサポートしています。
TRTCとは何ですか。
Tencent Real-Time Communication（TRTC）は、Tencentが長年にわたり蓄積したネットワークとオーディオ・ビデオ技術をベースに、多人数のオーディオビデオ通話と低遅延インタラクションライブストリーミングの、シナリオ化した2大ソリューションを提供し、Tencent Cloudのサービスを通じて開発者向けに開放します。これにより、開発者が低コスト、低遅延、高品質のインタラクティブな音声ビデオソリューションを迅速に構築することを支援します。詳細については、製品概要をご参照ください。
TRTCのDemoはどのように体験できますか。
TRTCはどのようにクイックスタートしますか。
TRTCはどのようにクラウドレコーディングと再生を実現しますか。
TRTCは美顔をサポートしていますか。
美顔機能をサポートしています。TRTCは、顔認識技術をベースとしたAI美顔、メイクアップ、プチ整形、クロマキーなど多彩なエフェクトを提供します。
Web端末では、美顔を有効にするをご参照ください。
クライアントのAI美顔は付加価値サービスであり、Tencent Effect SDKによって課金されます。
説明：
全機能版のみ、美顔エフェクトコンポーネントをサポートしています。現段階では、iOSとAndroidプラットフォームにこの機能があります。
中国本土以外の地域での使用には対応していますか。
TRTCは海外や中国香港での使用に対応しています。
説明：
全世界をカバーする高い接続性、高信頼性を有する、強力なセキュリティのネットワーク接続チャネルを提供します。自社開発した最適な多重アドレッシングアルゴリズムにより、ネットワーク全体のスケジューリング機能を備えています。豊富な高帯域幅リソースのストックと、グローバルなノードのレイアウトによって、国際間リンクのエンドツーエンド平均遅延300ms未満を保証します。
国際リンクの問題により、地域や実際のユースケースなどの要因からも影響を受けます。
リアルタイムでの不適切なコンテンツ検出をサポートしていますか。
ポルノ、政治、センシティブ情報については、自動的にブロックされて閉じられ、ライブストリーミングルームに表示されることはありません。
現在ルームにいる全ユーザーの情報を照会するにはどうすればよいですか。
現時点では、現在ルームにいる全ユーザー情報の照会はサポートされていません。
TRTCは他のRTSPプッシュを受信できますか。
TRTCはステレオエンコードをサポートしていますか。
ステレオをサポートしています。
TRTCプッシュでは、カプセル化が先でしょうか、それともエンコードが先でしょうか。
TRTCをキャプチャし、エンコードした後にカプセル化します。
TRTC SDKはswift版ですか。
TRTCでは現在、Model層はOC版、UI層はSwift版となっています。
個人アカウントでTRTCを利用することはできますか。
TRTCは、個人アカウントでの利用をサポートしています。
はい
いいえ
この記事はお役に立ちましたか？