このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

MediaTrackConstraints: suppressLocalAudioPlayback プロパティ

利用可能性は限定的

この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。

もっと多くのブラウザーがこの機能に対応してほしいですか? 理由を教えてください。

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

MediaTrackConstraints 辞書の suppressLocalAudioPlayback プロパティは、要求または必須の制約を記述する ConstrainBoolean で、制約可能プロパティ suppressLocalAudioPlayback の値に適用されます。 このプロパティは、タブがキャプチャされたときに、タブ内で再生される音声がユーザーのローカルスピーカーから引き続き再生されるかどうかを制御します。

必要であれば、この制約に対応しているかどうかを、suppressLocalAudioPlayback の値を確認することで判断できます。 この値は MediaDevices.getSupportedConstraints() の呼び出しで返されます。 ただし、ブラウザーは通常、認識できない制約を無視するため、この確認は不要です。

値

ConstrainBoolean 値です。

値が単純な true または false の場合、ユーザーエージェントは指定されたとおりローカル音声再生を有効または無効にしたメディアの取得を試みます。 可能な場合に取得し、できなくても失敗しません。

値が ideal フィールドを持つオブジェクトの場合、そのフィールドの論理値はローカル音声再生抑制機能に対する理想的な設定を示します。 この設定を満たせない場合、リクエストでエラーが発生します。

例

js
let isLocalAudioSuppressed = displayStream
  .getVideoTracks()[0]
  .getSettings().suppressLocalAudioPlayback;

メディアトラック制約の使い方は、制約エクササイザーの例で確認できます。

仕様書

仕様書
Screen Capture
# dom-mediatrackconstraintset-suppresslocalaudioplayback

ブラウザーの互換性

関連情報