MediaTrackConstraints: echoCancellation プロパティ
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年1月以降、すべてのブラウザーで利用可能です。
MediaTrackConstraints 辞書の echoCancellation プロパティは、要求または必須の制約を記述する ConstrainBooleanOrDOMString で、制約可能プロパティ echoCancellation の値に適用されます。
必要であれば、この制約に対応しているかどうかを、echoCancellation の値を確認することで判断できます。
この値は MediaDevices.getSupportedConstraints() の呼び出しで返されます。
ただし、ブラウザーは通常、認識できない制約を無視するため、この確認は不要です。
値
論理値、文字列、または ConstrainBooleanOrDOMString オブジェクトです。
ブラウザーが特定のエコーキャンセル種別に対応している場合、値には次のいずれかを設定できます。
"all"-
ユーザーのシステムで生成され、ユーザーのマイクがキャプチャしたすべての音声を除去します。例えば、スクリーンリーダーの出力やシステム通知など、プライバシーに関わる音声のキャプチャを避けたい場合に役立ちます。
"remote-only"-
ユーザーのシステムで生成され、ユーザーのマイクがリモートソースからキャプチャした音声だけを除去します。リモートソースは
MediaStreamTrackで表され、そのソースはRTCPeerConnectionです。この設定は、ローカル音声を共有しながらリモートピアとの通信からエコーを除去したい場合に役立ちます。例えば音楽のレッスンで、教師が音声トラックに合わせて演奏する生徒の音を聞きながら、生徒と明瞭に会話したい場合です。 true-
マイクが記録した信号からどの音声を除去するかは、ブラウザーが決定します。少なくとも
remote-onlyと同程度のエコーキャンセルを試みる必要があり、allと同程度のエコーキャンセルを試みるべきです。 false-
音声は除去されず、エコーキャンセルも行われません。
ブラウザーが特定のエコーキャンセル種別に対応していない場合、値には true または false を指定できます。
上記のいずれかの値が設定されている場合、ユーザーエージェントは指定されたとおりエコーキャンセルを有効または無効にしたメディアを取得しようとします。可能な場合に取得し、できなくても失敗しません。
値が exact フィールドを持つオブジェクトの場合、そのフィールドの値はエコーキャンセル機能に必要な設定を示します。その要件を満たせない場合、リクエストでエラーが発生します。
例
制約エクササイザーの例を参照してください。
仕様書
| 仕様書 |
|---|
| Media Capture and Streams> # dom-mediatrackconstraintset-echocancellation> |