通話開始前に、ネットワークおよびデバイスのテストをする方法はありますか ? – Agora

質問・問題

通話開始前に、ネットワークおよびデバイスのテストをする方法はありますか ?

Video/Voice SDK には、ネットワーク品質をを測定するプローブテスト、およびカメラ・マイクデバイスの動作確認のためのエコーテスト (ループテスト) 機能を提供しています。

※ WebSDK は対象外となります

ネットワークプローブテストは、ユーザーがチャンネル接続前に、ラストマイルネットワークの品質を確認いただける機能です。

このテストでは、往復レイテンシ、パケット損失率、ネットワーク帯域幅を含むネットワーク品質の統計情報を返します。

エコーテストは、ユーザーデバイス (マイク・カメラ) からキャプチャしたデータを一度 Agora SD-RTN™ に送信し、その約 2 秒後に返送されるデータをユーザーデバイス上で再生させ、デバイス動作およびネットワーク接続それぞれ確認するための機能です。

一部のプラットフォーム (Windows, macOS) 対象ですが、ネットワークを介さずに、デバイス動作を確認いただける API が用意されています。
※ React Native 用の SDK は対象外となります (2023-06 時点)

ネットワークプローブテスト中、他の API をコールした場合、そのテスト用のイベントコールバックが中断される場合があります。
ネットワークプローブテストの初回、イベントコールバック (onLastmileQuality) から返される計測結果が UNKNOWN となる場合があります。その場合、再度計測を実施してください。
チャンネルプロファイルが LIVE_BROADCASTING の場合、ホストのみエコーテストを利用できます。
エコーテストまたはデバイステストの実施 (start…) が終了しましたら、対応する停止 API (stop…) をコールください。

利用可能な API の情報・諸注意等は各種 API リファレンスの「Pre-call network test」ならびに「Audio Device Management (または Device manager)」のセクションからご覧ください。
4.x の実装例については Agora Docs の Call quality をご覧ください。
3.x の実装例については Agora Docs の Pre-call Network and Device Tests をご覧ください。