MediaTrackConstraints: suppressLocalAudioPlayback プロパティ
利用可能性は限定的
この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。
もっと多くのブラウザーがこの機能に対応してほしいですか? 理由を教えてください。
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
MediaTrackConstraints 辞書の suppressLocalAudioPlayback プロパティは、要求または必須の制約を記述する ConstrainBoolean で、制約可能プロパティ suppressLocalAudioPlayback の値に適用されます。
このプロパティは、タブがキャプチャされたときに、タブ内で再生される音声がユーザーのローカルスピーカーから引き続き再生されるかどうかを制御します。
必要であれば、この制約に対応しているかどうかを、suppressLocalAudioPlayback の値を確認することで判断できます。
この値は MediaDevices.getSupportedConstraints() の呼び出しで返されます。
ただし、ブラウザーは通常、認識できない制約を無視するため、この確認は不要です。
値
ConstrainBoolean 値です。
値が単純な true または false の場合、ユーザーエージェントは指定されたとおりローカル音声再生を有効または無効にしたメディアの取得を試みます。
可能な場合に取得し、できなくても失敗しません。
値が ideal フィールドを持つオブジェクトの場合、そのフィールドの論理値はローカル音声再生抑制機能に対する理想的な設定を示します。
この設定を満たせない場合、リクエストでエラーが発生します。
例
let isLocalAudioSuppressed = displayStream
.getVideoTracks()[0]
.getSettings().suppressLocalAudioPlayback;
メディアトラック制約の使い方は、制約エクササイザーの例で確認できます。
仕様書
| 仕様書 |
|---|
| Screen Capture> # dom-mediatrackconstraintset-suppresslocalaudioplayback> |