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

View in English Always switch to English

MediaTrackConstraints: logicalSurface プロパティ

利用可能性は限定的

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

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

MediaTrackConstraints 辞書の logicalSurface プロパティは、要求または必須の制約を記述する ConstrainDOMString で、制約可能プロパティ logicalSurface の値に適用されます。

これは、getDisplayMedia() で、画面上に完全に表示されているとは限らない表示面をユーザーが選べるようにするかどうかを指定するために使います。 例えば、ほかのウィンドウに隠れているウィンドウや、スクロールしないと内容全体が見えないほど大きなウィンドウの全内容などです。

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

値

ConstrainBoolean は、ユーザーが選べる項目に論理的な表示面を含める場合に true となる値です。

制約の定義方法を参照してください。

使用上の注意

表示メディアが getDisplayMedia() によって作成された後にユーザーエージェントが選択した設定は、表示メディアの動画 MediaStreamTrack で getSettings() を呼び出し、logicalSurface プロパティの値を確認することでわかります。

例えば、選択された表示面が論理的な表示面かどうかをアプリケーションが確認する必要がある場合は、次のようにします。

js
let isLogicalSurface = displayStream
  .getVideoTracks()[0]
  .getSettings().logicalSurface;

このコードの実行後、ストリームに含まれる表示面が論理的な表示面(画面内にすべて表示されているとは限らず、完全に画面外にある場合もあります)の場合、isLogicalSurface は true になります。

仕様書

仕様書
Screen Capture
# dom-mediatrackconstraintset-logicalsurface

ブラウザーの互換性

関連情報