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

View in English Always switch to English

MediaTrackConstraints: deviceId プロパティ

Baseline
広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2017年9月以降、すべてのブラウザーで利用可能です。

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

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

RTP にはこの情報が含まれていないため、WebRTC の RTCPeerConnection に関連付けられているトラックには、このプロパティは含まれません。

値

ConstrainDOMString に基づくオブジェクトで、受け入れ可能な値、理想的な値、または必須の値 (exact)、あるいはそれらの組み合わせとして、機器 ID を 1 つ以上指定します。 これらの ID は、メディアコンテンツのソースとして受け入れ可能なものです。

機器 ID はオリジンごとに一意で、同じオリジンではブラウジングセッションをまたいでも同じ値になることが保証されています。 ただし、deviceId の値はトラックのコンテンツのソースによって決まり、仕様書では特定の形式が必須とされていません(何らかの GUID が推奨されています)。 つまり、特定のトラックが返す deviceId の値は 1 つだけです。 これは、getCapabilities() を呼び出したときに返されます。

このため、MediaStreamTrack.applyConstraints() の呼び出しで deviceId を使用しても意味がありません。 指定できる値は 1 つだけだからです。 ただし、deviceId を記録しておけば、同じソースを取得するために、複数回の getUserMedia() の呼び出しでそれを使用できます。

メモ: 機器 ID がブラウジングセッションをまたいでも同じになるという規則には、例外があります。 プライベートブラウジングモードでは異なる ID が使用され、セッションごとにその ID が変わります。

例

制約エクササイザーの例を参照してください。

仕様書

仕様書
Media Capture and Streams
# dom-mediatrackconstraintset-deviceid

ブラウザーの互換性

関連情報