MediaStream: getVideoTracks() メソッド
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2017年9月.
getVideoTracks() は MediaStream インターフェイスのメソッドで、このストリームに含まれる動画トラックを表す MediaStreamTrack オブジェクトの配列を返します。
構文
js
getVideoTracks()
引数
なし。
返値
MediaStreamTrack オブジェクトの配列で、それぞれがメディアストリームに含まれるそれぞれの動画トラックを表します。動画トラックは kind プロパティが video であるトラックです。ストリームに動画トラックが含まれていない場合、配列は空となります。
メモ:
トラックの順序は仕様で定義されておらず、 getVideoTracks() の呼び出しごとに同じ順序になるとは限りません。
例
次の例は、 Chrome's
Image Capture / Photo Resolution Sample (英語)から抜粋したものであり、 getVideoTracks() を用いて取得したトラックを ImageCapture() コンストラクターへ渡しています。
js
let imageCapture;
navigator.mediaDevices.getUserMedia({ video: true }).then((mediaStream) => {
document.querySelector("video").srcObject = mediaStream;
const track = mediaStream.getVideoTracks()[0];
imageCapture = new ImageCapture(track);
return imageCapture.getPhotoCapabilities();
});
仕様書
| Specification |
|---|
| Media Capture and Streams # dom-mediastream-getvideotracks |