MediaStream: getVideoTracks() 方法

Baseline 已廣泛支援

此功能已成熟,可跨多種裝置和瀏覽器版本使用。自 2017 年 9 月以來,它已在瀏覽器中提供。

MediaStream 介面的 getVideoTracks() 方法返回一個 MediaStreamTrack 物件序列,這些物件代表了此流中的影片軌道。

語法

js
getVideoTracks()

引數

無。

返回值

一個 MediaStreamTrack 物件陣列,每個物件對應媒體流中包含的一個影片軌道。影片軌道是指其 kind 屬性為 video 的軌道。如果流不包含任何影片軌道,則該陣列為空。

注意: 軌道的順序不受規範定義,並且在每次呼叫 getVideoTracks() 時可能不盡相同。

示例

以下示例摘自 Chrome 的 Image Capture / Photo Resolution 示例,它使用 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();
});

規範

規範
媒體捕獲和流
# dom-mediastream-getvideotracks

瀏覽器相容性