VideoFrame: rotation 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

注意:此功能在 專用 Web Workers 中可用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

VideoFrame 介面的 rotation 屬性返回影片幀的旋轉角度。

一個整數,表示順時針旋轉的角度(0、90、180 或 270)。預設為 0。任意數字(包括負數)將四捨五入到最近的四分之一圈。

示例

檢測攝像頭影片是否旋轉

給定一個使用 MediaStreamTrackProcessor 獲取的攝像頭影片幀流,你可以檢查 VideoFrame 物件的 rotation 屬性,以檢視幀是否旋轉。

js
const stream = await navigator.mediaDevices.getUserMedia({ video: true });
const track = stream.getTracks()[0];

const trackProcessor = new MediaStreamTrackProcessor(track);

const reader = trackProcessor.readable.getReader();
while (true) {
  const result = await reader.read();
  if (result.done) break;
  const frameFromCamera = result.value;
  // Returns 0, 90, 180, or 270 indicating the frame's rotation
  console.log(frameFromCamera.rotation);
}

規範

規範
WebCodecs
# dom-videoframe-rotation

瀏覽器相容性