tencent cloud

1、基本環境についての質問

Web端末SDKはどのブラウザをサポートしていますか？

TRTC Web SDKの、ブラウザに対する詳細なサポートの程度については、TRTC Web SDKのブラウザサポート状況をご参照ください。
上記に記載されていない環境については、現在のブラウザでTRTC能力テストを開き、WebRTC機能を完全にサポートしているかテストすることができます。

通話前の音声ビデオデバイステストについて知りたいです。

通話前の環境およびデバイステストで確認できます。

現在のネットワーク状況をリアルタイムに検出するにはどうすればよいですか？

具体的には通話前のネットワーク品質テストをご参照ください。

ローカルの開発テストではTRTC Web SDKを正常に使用できましたが、オンラインにデプロイすると使用できなくなりました。なぜですか？

ユーザーに対するセキュリティ、プライバシーなどの観点から、ブラウザの制限ページは安全な環境下（例えば、https、localhost、file://などのプロトコル）でなければ、マイク、カメラのキャプチャが行えないようになっています。HTTPプロトコルは安全ではないため、ブラウザはHTTPプロトコルでのメディアデバイスのキャプチャを禁止する場合があります。

ローカルの開発テストではすべて正常でも、ウェブページのデプロイ後にカメラ、マイクを正常にキャプチャできなくなった場合は、ウェブページがHTTPプロトコルにデプロイされているかどうかを確認してください。もしデプロイされていなければ、HTTPSを使用してウェブページのデプロイを行ってください。その場合は適切なHTTPSセキュリティ証明書があることを確認してください。

詳細情報については、URLドメイン名およびプロトコル制限の説明をご参照ください。

ミクスストリーミング、Relayed Push、ビッグスモールストリーム、美顔、ウォーターマークをサポートしていますか。

ミクスストリーミング、Relayed Push、ビッグスモールストリーム、美顔、ウォーターマークをご参照ください。これらのドキュメントを参照して高度な機能を実現することができます。

WebRTCの既知の問題にはどのようなものがありますか？

具体的には、WebRTCの既知の問題と回避方法をご参照ください。

2、プッシュプルストリームについての質問

Web端末SDKログのエラーメッセージのうち、NotFoundError、NotAllowedError、NotReadableError、OverConstrainedErrorおよびAbortErrorは、それぞれどういう意味ですか？

エラー名	説明	推奨する対処方法
NotFoundError	リクエストを満たすパラメータのメディアタイプ（オーディオ、ビデオ、画面共有を含む）が見つかりません。例えば、PCにカメラがないのに、ブラウザにビデオストリームを取得するようリクエストがあった場合、このエラーが発生します。	ユーザーが通話を開始する前に、通話に必要なカメラやマイクなどのデバイスを確認することをお勧めします。カメラがなく、音声通話を行う必要がある場合は、TRTC.createStream({ audio: true, video: false })で、マイクのみをキャプチャするように指定できます。
NotAllowedError	ユーザーが、現在のブラウザ・インスタンスのオーディオ、ビデオおよび画面共有へのアクセスのリクエストを拒否しました。	ユーザーに対し、カメラ/マイクへのアクセス権限を承認しないと、オーディオビデオ通話を行うことができません、というプロンプトが表示されます。
NotReadableError	権限が付与されたユーザーが対応するデバイスを使用していますが、OS上のいずれかのハードウェア、ブラウザまたはWebページの階層に発生したエラーのため、デバイスにアクセスできません。	ブラウザのエラーメッセージに従って処理すると、ユーザーに対し、「現在カメラ/マイクにアクセスできません。他のアプリケーションがカメラ/マイクへのアクセスをリクエストしていないことを確認してから、もう一度お試しください」というプロンプトが表示されます。
OverConstrainedError	cameraId/microphoneIdのパラメータの値が無効です。	cameraId/microphoneIdの渡された値が正しく有効であることを確認してください。
AbortError	何らかの理由により、デバイスを使用できません。	-

詳細については、initializeをご参照ください。

一部の携帯電話で、ブラウザがTRTCを正常に実行してプッシュプルストリームを行うことができません。

TRTC Web SDKの、ブラウザに対する詳細なサポートの程度については、TRTC Web SDKのブラウザサポート状況をご参照ください。
上記に記載されていない環境については、現在のブラウザでTRTC能力テストを開き、WebRTC機能を完全にサポートしているかテストすることができます。

Web端末の幅と高さによって設定されるプッシュの解像度の設定は、すべてのブラウザに適用されますか。

デバイスとブラウザの制限によって、ビデオの解像度が完全にマッチするとは限りません。マッチしない場合、ブラウザは自動的に解像度を調整し、Profileに対応する解像度に近づけます。詳細については、setVideoProfileをご参照ください。

Web端末の画面共有形式の変更はサポートしていますか？

画面共有形式はブラウザによって制御されており、現在は変更できません。

Web端末ではミックスストリーミングをサポートしていますか？

Web端末ではミックスストリーミングの開始をサポートしています。具体的にはミックスストリーミングトランスコードインターフェースの呼び出し方法をご参照ください。

Web端末SDKの使用中にカメラを取り外したときに、カメラリストのデータをクリアにするにはどうしたらいいですか？

TRTC.getCameras メソッドを呼び出し、新しいデバイスリストを取得してみてください。取り外したカメラの情報がまだある場合は、ブラウザの最下層がリストを更新しておらず、Web端末SDKも新しいデバイスリストの情報を取得できないことを意味します。

iOSのWeChat Embeddedブラウザで正常なプッシュが行えません。

ブラウザサポート状況を参照し、iOS上でのWeChat Embeddedブラウザのプッシュプルストリームに対するサポート状況をご確認ください。

3、再生についての質問

インタラクティブな音声ビデオ通信中に、画面は映るが音声は出ないという問題が発生しました。

• ブラウザの自動再生ポリシーの制限により、オーディオ再生においてPLAY_NOT_ALLOWEDの異常が生じる場合があります。この場合、ビジネス層では、ユーザーにStream.resume()をマニュアルで操作させてオーディオ再生を再開する必要があります。具体的には制限された自動再生の処理に関するアドバイスをご参照ください。
• 未知の異常による場合は、監視ダッシュボードで送受信双方のaudioLevel & audioEnergyを確認してください。

Web通話画面が表示されません。

Web画面上でデータを取得できているかどうかを確認します。データの送受信が正常であれば、<video>要素のsrcObject属性が正しいmediaStreamオブジェクトに割り当てられているかどうかを確認します。割り当てに誤りがあれば、表示されません。

Web通話中にエコー、雑音、ノイズ、音量が小さくなる問題が発生します。

通話双方のデバイス間の距離が近すぎる場合に発生する正常な現象です。テストの際に距離を少し離してみてください。他の端末でWeb端末の音声のエコー、ノイズ、雑音などが聞こえる場合、Web端末の3A処理が有効になっていないことを意味します。
ブラウザネイティブのgetUserMediaAPIを使用してユーザー定義キャプチャを行っている場合は、3Aパラメータを手動で設定してください。

• echoCancellation：エコーキャンセルスイッチ
• noiseSuppression：ノイズ抑制スイッチ
• autoGainControl：自動ゲインスイッチ。詳細な設定については、メディアトラック制約をご参照ください。

TRTC.createStreamインターフェースを使用してキャプチャを行う場合は、3Aパラメータを手動で設定する必要はありません。SDKでは3Aがデフォルトでオンになっています。

4、その他

2.x、3.xバージョンのSDKでは、Chrome 96+バージョンで正常に通話できないのですが、どうすればよいですか？

最新バージョンのChrome 96のPlan-B廃止により、TRTCの旧バージョン(2.x, 3.x)のWeb SDKにおいて、通話ができない状況が発生しています。お早めにWeb SDKを最新バージョン(4.x)にアップグレードしてください。バージョン4.xのSDKのインターフェースは旧バージョン(2.x, 3.x)と互換性を有しないため、クイックインテグレーション(Web)を参照し、バージョン4.xのSDKへのアップグレードを行ってください。

Web端末でSDKを実行すると、「RtcError: no valid ice candidate found」というエラーが表示されますが、どうすればいいですか？

このエラーが発生した場合、TRTCデスクトップブラウザSDKがSTUNトンネリングに失敗したことを意味しますので、ファイアウォールのコンフィグレーションを確認してください。TRTCデスクトップ型ブラウザSDKは以下のポートに依存してデータ伝送を行います。それをファイアウォールのホワイトリストに追加して設定を完了してから、 公式サイトDemoにアクセスして体験していただけば、設定が有効かどうかチェックすることができます。

具体的には、ファイアウォール制限の対応関連をご参照ください。

クライアントエラー："RtcError: ICE/DTLS Transport connection failed" または “RtcError: DTLS Transport connection timeout”が出現したときの対処方法は？

このエラーの出現は TRTC デスクトップブラウザ SDKがメディア転送パスの構築時に失敗したことを意味しますので、ファイアウォールの設定をチェックしてください。TRTC デスクトップブラウザ SDKは、以下のポートに依存してデータ転送を行いますので、これらをファイアウォールのホワイトリストに追加してください。設定完了後、 公式サイトのDemo にアクセスして体験し、設定が有効かをチェックすることができます。

具体的には、ファイアウォール制限の対応関連をご参照ください。

Web端末SDKは現在の音量を取得できますか？

getAudioLevelで現在の音量を取得することができます。具体的には、Detecting Volumeをご参照ください。

Client.on(‘client-banned’)はどのような状況でトリガーされますか？

ユーザーがキックされた場合にこのイベントがトリガーされます。例えば、同名のユーザーが同時にログインした場合、バックエンドのRESTAPIユーザーの削除を呼び出して、ユーザーを強制退室させた場合などです。

注意：

同名ユーザーの同時ログインは許可されない行為であり、双方の通話異常を起こすおそれがあるため、ビジネス層では同名ユーザーの同時ログインを避けなければなりません。

より具体的な詳細については、CLIENT_BANNEDイベントをご参照ください。

Web版は、リモート端末の退室をモニタリングできますか？

リモート端末の退室イベントのモニタリングをサポートしています。クライアントイベントの中の client.on('peer-leave') イベントを使用し、リモートユーザーの退室通知を実現することをお勧めします。

TRTCのWeb端末、PC端末は相互通信できますか。

できます。TRTCでは全プラットフォームの相互通信をサポートしています。

TRTC Web端末のスクリーンキャプチャ機能は、どうすれば実装できますか？

具体的には、Stream.getVideoFrame()のインターフェースをご参照ください。

Web端末SDKは、ピュアオーディオのプッシュをどのようにレコーディングしますか？コンソールでAuto-relayと自動レコーディングを起動できないのはなぜですか？

createClient の pureAudioPushMode パラメータを設定してください。

Client.on(‘error’)が発生したときはどう対処すればよいですか？

これは、SDKにリカバリできないエラーが起こったことを表します。ビジネス層では、画面を更新してリトライするか、またはClient.leaveを呼び出して退室した後、再度Client.joinを呼び出してリトライします。

ミニプログラムとWeb端末はカスタムストリームIDをサポートしていますか？

Web端末4.3.8以降のバージョンではカスタムストリームIDがサポートされているので、SDKのバージョンを更新してください。ミニプログラムは現時点ではサポートしていません。

Web端末で画面共有の際にシステム音声をキャプチャするにはどうすればよいですか？

具体的な操作については、画面共有時のシステム音声キャプチャをご参照ください。
現時点でシステム音声キャプチャはChrome M74+のみサポートしており、WindowsおよびChrome OS上ではシステム全体のオーディオをキャプチャすることができ、LinuxおよびMacではオプションタブのオーディオのみキャプチャできます。その他のChromeのバージョン、その他のシステム、その他のブラウザはいずれもサポートしていません。

Web端末でカメラおよびマイクを切り替えるにはどうすればよいですか？

先にシステムのカメラおよびマイクデバイスを取得してから、switchDeviceを呼び出せば切り替えることができます。具体的な操作については、カメラとマイクの切り替えをご参照ください。

iframeでTRTC Web SDKを使用して、Permission deniedのエラーが発生する場合はどうすればよいですか？

iframeでWebRTCを使用するには、iframeタグに属性を追加して、関連する権限を有効にしてください。詳細については、以下をご参照ください。
マイク、カメラ、画面共有の権限：

<iframe allow="microphone; camera; display-capture;">