tencent cloud

Tencent Real-Time Communication

お知らせ・リリースノート
製品アップデート情報
Tencent Cloudオーディオビデオ端末SDKの再生アップグレードおよび承認チェック追加に関するお知らせ
TRTCアプリケーションのサブスクリプションパッケージサービスのリリースに関する説明について
製品の説明
製品概要
基礎概念
製品の機能
製品の強み
ユースケース
性能データ
購入ガイド
Billing Overview
無料時間の説明
Monthly subscription
Pay-as-you-go
TRTC Overdue and Suspension Policy
課金に関するよくあるご質問
Refund Instructions
初心者ガイド
Demo体験
Call
コンポーネントの説明(TUICallKit)
Activate the Service
Run Demo
クイック導入
オフライン通知
Conversational Chat
クラウドレコーディング(TUICallKit)
AI Noise Reduction
インターフェースのカスタマイズ
Calls integration to Chat
Additional Features
No UI Integration
Server APIs
Client APIs
Solution
ErrorCode
公開ログ
よくある質問
ライブ配信
Billing of Video Live Component
Overview
Activating the Service (TUILiveKit)
Demo のクイックスタート
No UI Integration
UI Customization
Live Broadcast Monitoring
Video Live Streaming
Voice Chat Room
Advanced Features
Client APIs
Server APIs
Error Codes
Release Notes
FAQs
RTC Engine
Activate Service
SDKのダウンロード
APIコードサンプル
Usage Guidelines
クライアント側 API
高度な機能
RTC RESTFUL API
History
Introduction
API Category
Room Management APIs
Stream mixing and relay APIs
On-cloud recording APIs
Data Monitoring APIs
Pull stream Relay Related interface
Web Record APIs
AI Service APIs
Cloud Slicing APIs
Cloud Moderation APIs
Making API Requests
Call Quality Monitoring APIs
Usage Statistics APIs
Data Types
Appendix
Error Codes
コンソールガイド
アプリケーション管理
使用統計
監視ダッシュボード
開発支援
Solution
Real-Time Chorus
よくあるご質問
課金関連問題
機能関連
UserSig関連
ファイアウォールの制限の対応関連
インストールパッケージの圧縮に関するご質問
AndriodおよびiOS関連
Web端末関連
Flutter関連
Electron関連
TRTCCalling Web関連
オーディオビデオ品質関連
その他のご質問
旧バージョンのドキュメント
TUIRoom(Web)の統合
TUIRoom (Android)の統合
TUIRoom (iOS)の統合
TUIRoom (Flutter)の統合
TUIRoom (Electron)の統合
TUIRoom APIのクエリー
クラウドレコーディングと再生の実現(旧)
Protocols and Policies
セキュリティコンプライアンス認証
セキュリティホワイトペーパー
情報セキュリティの説明
Service Level Agreement
Apple Privacy Policy: PrivacyInfo.xcprivacy
TRTC ポリシー
プライバシーポリシー
データ処理とセキュリティ契約
用語集

API 総覧

PDF
フォーカスモード
フォントサイズ
最終更新日: 2024-07-19 15:29:07

サポートするプラットフォーム

TRTC Web SDKはWebRTCをベースに実現しており、現在デスクトップおよびモバイル端末の主流ブラウザをサポートしています。サポートの程度の詳細については下の表をご参照ください。 サポート対象の表内にユースケースが見当たらない場合は、TRTC Web SDK機能テスト画面を開き、現在の環境がWebRTCのすべての機能をサポートしているかどうかチェックすることができます(例:WebViewなどの環境)。
OS
ブラウザタイプ
ブラウザの最小バージョン要件
SDKのバージョン要件
受信(再生)
送信(マイク・オン)
画面共有
Windows
デスクトップ版Chromeブラウザ
56+
-
サポートしています
サポートしています
Chrome72以降のバージョンをサポート
デスクトップ版QQブラウザ(クイックコア)
10.4+
-
サポートしています
サポートしています
サポートしていません
デスクトップ版Firefoxブラウザ
56+
v4.7.0+
サポートしています
サポートしています
Firefox66以降のバージョンをサポート
デスクトップ版Edgeブラウザ
80+
v4.7.0+
サポートしています
サポートしています
サポートしています
デスクトップ版Sogouブラウザ(高速モード)
11+
v4.7.0+
サポートしています
サポートしています
サポートしています
デスクトップ版Sogouブラウザ(互換モード)
-
-
サポートしていません
サポートしていません
サポートしていません
デスクトップ版Operaブラウザ
46+
v4.7.0+
サポートしています
サポートしています
Opera60以降のバージョンをサポート
デスクトップ版360SEブラウザ(超高速モード)
13+
v4.7.0+
サポートしています
サポートしています
サポートしています
デスクトップ版360SEブラウザ(互換モード)
-
-
サポートしていません
サポートしていません
サポートしていません
デスクトップ版WeChat Embeddedブラウザ
-
-
サポートしています
サポートしていません
サポートしていません
デスクトップ版WeCom Embeddedブラウザ
-
-
サポートしています
サポートしていません
サポートしていません
Mac OS
デスクトップ版Safariブラウザ
11+
-
サポートしています
サポートしています
Safari13以降のバージョンをサポート
デスクトップ版Chromeブラウザ
56+
-
サポートしています
サポートしています
Chrome72以降のバージョンをサポート
デスクトップ版Firefoxブラウザ
56+
v4.7.0+
サポートしています
サポートしています
Firefox66以降のバージョンをサポート(注意[3])
デスクトップ版Edgeブラウザ
80+
v4.7.0+
サポートしています
サポートしています
サポートしています
デスクトップ版Operaブラウザ
46+
v4.7.0+
サポートしています
サポートしています
Opera60以降のバージョンをサポート
デスクトップ版WeChat Embeddedブラウザ
-
-
サポートしています
サポートしていません
サポートしていません
デスクトップ版WeCom Embeddedブラウザ
-
-
サポートしています
サポートしていません
サポートしていません
Android
WeChat Embeddedブラウザ(TBSコア)
-
-
サポートしています
サポートしています
サポートしていません
WeChat Embeddedブラウザ(XWEBコア)
-
-
サポートしています
サポートしています
サポートしていません
WeCom Embeddedブラウザ
-
-
サポートしています
サポートしています
サポートしていません
モバイル版Chromeブラウザ
-
-
サポートしています
サポートしています
サポートしていません
モバイル版QQブラウザ
-
-
サポートしていません
サポートしていません
サポートしていません
モバイル版UCブラウザ
-
-
サポートしていません
サポートしていません
サポートしていません
iOS 12.1.4+
WeChat Embeddedブラウザ
-
-
サポートしています
サポートしていません
サポートしていません
iOS 14.3+
WeChat Embeddedブラウザ
6.5+(WeChatバージョン)
-
サポートしています
サポートしています
サポートしていません
iOS
WeCom Embeddedブラウザ
-
-
サポートしています
サポートしていません
サポートしていません
iOS 11.1.2+
モバイル版Safariブラウザ
11+
-
サポートしています
サポートしています
サポートしていません
iOS 12.1.4+
モバイル版Chromeブラウザ
-
-
サポートしています
サポートしていません
サポートしていません
iOS 14.3+
モバイル版Chromeブラウザ
-
-
サポートしています
サポートしています
サポートしていません
ご注意:
H.264の著作権上の制限により、Huawei Chrome 88以前のバージョンではH264コーデックを使用できません(プッシュできません)。HuaweiデバイスのChromeブラウザでTRTC Web SDKプッシュをご利用になりたい場合は、チケットを提出し、VP8コーデックの有効化を申請してください。
Mac OSでのFirefoxの画面共有機能はあまり効果的ではなく、現時点では対処方法もありません。そのため、画面共有にはChromeまたはSafariの使用をお勧めします。
Web端末でのプッシュ時のダブルサウンドチャンネルコーデックのサポートを希望される場合は、チケットを提出し、WebRTCダブルサウンドチャンネルコーデックを申請してください。
より良い製品安定性とオンラインサポートを得るために、TRTC Web SDKは適時に最新バージョンに更新することをお勧めします。バージョンアップに関する注意事項については、アップグレードガイドラインをご参照ください。

URLドメイン名プロトコルの制限

ブラウザのセキュリティポリシー上の制限により、WebRTC機能を使用したページへのアクセスプロトコルには厳格な要件があります。 以下の表を参照し、アプリケーションの開発とデプロイを行ってください。
ユースケース
プロトコル
受信(再生)
送信(マイク・オン)
画面共有
備考
本番環境
HTTPSプロトコル
サポートあり
サポートあり
サポートあり
推奨
本番環境
HTTPプロトコル
サポートあり
サポートなし
サポートなし

ローカル開発環境
サポートあり
サポートあり
サポートあり
推奨
ローカル開発環境
サポートあり
サポートあり
サポートあり

ローカル開発環境
http://[ローカルマシンIP]
サポートあり
サポートなし
サポートなし

ローカル開発環境
file:///
サポートあり
サポートあり
サポートあり


API使用ガイド

初期化フローおよびAPIの使用法の詳細については、以下のガイドをご参照ください。
機能
Sample Codeガイド
基本的なオーディオビデオ通話
インタラクティブライブストリーミングマイク接続の実装
カメラおよびマイクの切り替え
ローカルビデオのプロパティの設定
ローカルオーディオまたはビデオの動的な停止と開始
画面共有
音量計測
ユーザー定義キャプチャとカスタマイズ再生レンダリング
ルーム内アップリンクユーザー数の制限
バックグラウンドミュージックと効果音の実装ソリューション
通話前の環境およびデバイステスト
通話前のネットワーク品質テスト
デバイス挿抜動作チェック
CDNへのプッシュの実現
-
デュアルストリームの伝送を有効にする
美顔を有効にする
ウォーターマークを有効にする
ルーム間マイク接続の実現
クラウドミクスストリーミングの実装
クラウドレコーディングの実装
説明:
その他の機能についてはクリックして確認してください。
よくあるご質問についてはWeb端末関連をご参照ください。

APIの説明

TRTC

ご注意:
このドキュメントは4.x.xバージョンのTRTC Web SDKに適用されます。
TRTCはTRTC Web SDKのメインエントリで、TRTCメソッドによってTRTCのクライアントオブジェクト(Client)とローカルオーディオビデオストリーミングオブジェクト(Stream)を作成することができます。また、TRTCメソッドはブラウザの互換性や、画面共有をサポートするかをチェックしたり、ログレベルやログのアップロードを設定したりすることもできます。
API
説明
TRTC Web SDKバージョン番号。
ブラウザがTRTC Web SDKと互換性があるかチェックします。現在のブラウザとTRTC Web SDKとの互換性がない場合は、Chromeブラウザの最新バージョンをダウンロードするようユーザーに促すことをお勧めします。
ブラウザが画面共有をサポートしているかをチェックします。画面共有ストリームを作成する前に、このメソッドを呼び出して、現在のブラウザが画面共有をサポートしているか確認してください。
ブラウザがデュアルストリームモードの有効化をサポートしているかをチェックします。デュアルストリームモードを有効化する前に、このメソッドを呼び出して、現在のブラウザがデュアルストリームの有効化をサポートしているか確認してください。
メディアの入出力デバイスリストを返します。
カメラのデバイスリストを返します。
マイクのデバイスリストを返します。
スピーカーのデバイスリストを返します。
TRTC通話のクライアントオブジェクトを作成します。入退室、オーディオビデオストリーミングの公開、サブスクリプションなどの機能の実装に使用します。
ローカルストリームStreamオブジェクトを作成します。ローカルストリームStreamオブジェクトはpublish()メソッドによってオーディオビデオストリーミングをリリースします。

TRTC.Logger

ログ出力レベルの設定を含め、ログの設定方法を提供します。ログのアップロードを起動または停止します。
API
説明
ログ出力レベルを設定します。
ログのアップロードを起動します。
ログのアップロードを停止します。

Client

オーディオビデオ通話のクライアントオブジェクトClientはcreateClient()によって作成し、1回のオーディオビデオセッションを表します。
API
説明
プロキシサーバーを設定します。このメソッドは、nginx+coturn方式など、企業が自らプロキシサーバーをデプロイする場合に適用されます。
TURNサーバーを設定します。このメソッドはsetProxyServer()と合わせて使用し、企業が自らプロキシサーバーおよびTURN中継をデプロイする場合に適用されます。
オーディオビデオ通話ルームに参加し、入室によってオーディオビデオ通話セッションが始まります。ルームが存在しない場合、システムが自動的に新しいルームを作成します。
現在のオーディオビデオ通話ルームを退出し、オーディオビデオ通話セッションを終了します。
ローカルのオーディオビデオストリーミングを公開します。このメソッドはjoin()で入室後に呼び出す必要があり、1回のオーディオビデオセッションで1度だけローカルストリーミングを公開することができます。
ローカルストリーミングの公開を取り消します。
リモートストリーミングを閲覧します。
リモートストリーミングの閲覧を取り消します。
ユーザーロールを切り替えます。‘live’でインタラクティブライブストリーミングモードの時のみ有効になります。
SEIメッセージを送信します。
クライアントオブジェクトイベントを監視します。
クライアントオブジェクトイベントの監視を取り消します。
現在のルーム内にいるリモートユーザーのオーディオビデオのmute状態リストを取得します。
現在のネットワーク伝送状況の統計データテーブルを取得します。
現在公開済みのローカルストリーミングのオーディオ統計データを取得します。このメソッドはpublish()後に呼び出す必要があります。
現在公開済みのローカルストリーミングのビデオ統計データを取得します。このメソッドはpublish()後に呼び出す必要があります。
現在のすべてのリモートストリーミングのオーディオ統計データを取得します。
現在のすべてのリモートストリーミングのビデオ統計データを取得します。
現在のクライアントのオーディオビデオストリームのCDNへの公開を開始します。
現在のクライアントのオーディオビデオストリームのCDNへの公開を停止します。
ミクスストリーミングトランスコードを開始します。このインターフェースは入室し、プッシュしてから呼び出してください。
ミクスストリーミングトランスコードを停止します。このインターフェースはローカルストリームの公開(publish)成功後およびミクスストリーミングトランスコードの開始startMixTranscode成功後に呼び出してください。
音量コールバックを有効化または無効化します。
プッシュ側のデュアルストリームモードを有効化します。
プッシュ側のデュアルストリームモードを無効化します。
スモールストリームのパラメータを設定します。
視聴側でデュアルストリームの属性を切り替えます。リモートでスモールストリームを有効化していなければ切り替えは成功しません。

LocalStream

LocalStreamローカルオーディオビデオストリーミングは、createStreamで作成します。Streamのサブカテゴリーになります。
API
説明
ローカルのオーディオビデオストリーミングオブジェクトを初期化します。
オーディオProfileを設定します。このメソッドはinitialize()を呼び出す前に呼び出す必要があります。
ビデオProfileを設定します。このメソッドはinitialize()を呼び出す前に呼び出す必要があります。
画面共有Profileを設定します。このメソッドはinitialize()を呼び出す前に呼び出す必要があります。
ビデオコンテンツのヒントを設定します。主に、さまざまなシーンにおけるビデオコーデック品質の向上に用いられます。このメソッドはinitialize()の呼び出し完了後に呼び出す必要があります。
メディアの入力デバイスを切り替えます。
オーディオまたはビデオのトラックを追加します。
ビデオトラックを削除します。
オーディオまたはビデオのトラックを変更します。
このオーディオビデオストリーミングを再生します。
オーディオビデオストリーミングの再生を停止します。
オーディオビデオの再生を再開します。
オーディオビデオストリーミングを終了します。
オーディオトラックを無効にします。
ビデオトラックを無効にします。
オーディオトラックを有効にします。
ビデオトラックを有効にします。
Streamの固有識別IDを取得します。
このストリームが属するユーザーIDを取得します。
音声出力デバイスを設定します。
現在の音量を取得します。ローカルストリーミングまたはリモートストリーミングにオーディオデータがある場合のみ有効となります。
マイクキャプチャ音量を設定します。
オーディオトラックが含まれているかどうか。
ビデオトラックが含まれているかどうか。
オーディオトラックを取得します。
ビデオトラックを取得します。
現在のビデオフレームを取得します。
Streamイベントを監視します。
Streamイベントの監視を取り消します。

RemoteStream

リモートオーディオビデオストリーミングは、Client.on('stream-added')イベントの監視によって取得します。これはStreamのサブカテゴリーになります。
API
説明
リモートストリーミングのタイプを取得します。主に1つのリモートストリーミングがメインオーディオビデオストリーミングかサブビデオストリームかを判断することに用いられます。サブビデオストリームは通常、画面共有ストリームです。
このオーディオビデオストリーミングを再生します。
オーディオビデオストリーミングの再生を停止します。
オーディオビデオの再生を再開します。
オーディオビデオストリーミングを終了します。
オーディオトラックを無効にします。
ビデオトラックを無効にします。
オーディオトラックを有効にします。
ビデオトラックを有効にします。
Streamの固有識別IDを取得します。
このストリームが属するユーザーIDを取得します。
音声出力デバイスを設定します。
再生音量を設定します。
現在の音量を取得します。ローカルストリーミングまたはリモートストリーミングにオーディオデータがある場合のみ有効となります。
オーディオトラックが含まれているかどうか。
ビデオトラックが含まれているかどうか。
オーディオトラックを取得します。
ビデオトラックを取得します。
現在のビデオフレームを取得します。
Streamイベントを監視します。
Streamイベントの監視を取り消します。

RtcError

RtcErrorエラーオブジェクト。
API
説明
エラーコードを取得します。

ClientEvent

Clientがトリガーするイベントのリスト、すなわちclient.on('eventName')イベント監視中のイベント名eventNameです。
API
説明
リモートストリーム追加イベントです。リモートユーザーがストリームを公開した場合にこの通知を受信します。
リモートストリーム削除イベントです。リモートユーザーがストリームの公開を取り消した場合にこの通知を受信します。
リモートストリーム更新イベントです。リモートユーザーがオーディオビデオトラックを追加、削除または変更した場合にこの通知を受信します。
リモートストリームサブスクリプション成功イベントです。subscribe()を呼び出して成功した場合にこのイベントがトリガーされます。
ローカルclientとTencent Cloudの接続ステータス変更イベントです。
リモートユーザー入室イベントです。
リモートユーザー退室イベントです。
リモートストリームのオーディオ無効化イベントです。リモートユーザーがオーディオを無効にした場合にこのイベントがトリガーされます。
リモートストリームのビデオ無効化イベントです。リモートユーザーがビデオを無効にした場合にこのイベントがトリガーされます。
リモートストリームのオーディオ有効化イベントです。リモートユーザーがオーディオを有効にした場合にこのイベントがトリガーされます。
リモートストリームのビデオ有効化イベントです。リモートユーザーがビデオを有効にした場合にこのイベントがトリガーされます。
ユーザーの強制退室イベントです。強制退室の原因には次のものがあります。
同名のユーザーが同一のルームに入室した。注意:同名のユーザーが同時に同一のルームに入室することは、双方のオーディオビデオ通話に異常が生じることがあるため禁止されています。業務側はこのような状況を避けなければなりません。
アカウント管理者がサーバーAPIを使用して強制退室させた。
ネットワーク品質統計データイベントです。入室後に統計を開始し、2秒に1回トリガーします。アップおよびダウンストリームネットワーク品質データが含まれます。
音量イベントです。
enableAudioVolumeEvaluationインターフェースを呼び出して音量コールバックを有効化すると、SDKは決まった時間にこのイベントをスローし、各userIdの音量を通知します。
seiメッセージを受信します。
エラーイベントです。復旧できないエラーが発生すると、このイベントがスローされます。エラーコードをご参照ください。

StreamEvent

Streamによってトリガーされるイベントのリストです。
API
説明
Audio/Video Playerのステータス変更イベントです。
ローカル画面共有停止イベントです。ローカル画面共有ストリームに対してのみ有効です。
Stream接続ステータス変更イベントです。stream-addedイベントコールバックでこのイベントを監視し、stream-removedイベントコールバックでこのイベントの監視を取り消してください。
エラーイベントです。復旧できないエラーが発生すると、このイベントがスローされます。エラーコードをご参照ください。

お問い合わせ

ご不明な点がございましたら、colleenyu@tencent.comにご連絡ください。

ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック