VideoPlaybackQuality: totalVideoFrames 屬性

Baseline 已廣泛支援

此功能已成熟,並可在多種裝置和瀏覽器版本上執行。自 2019 年 3 月以來,它已在所有瀏覽器中可用。

VideoPlaybackQuality 介面的只讀屬性 totalVideoFrames 返回自媒體載入以來已顯示或已丟棄的總影片幀數。

自媒體載入到 <video> 元素以來,該元素已顯示或已丟棄的總幀數。本質上,這是該元素如果沒有出現問題“本應呈現”的幀數。

當媒體重新載入或替換時,此值將重置。

示例

此示例呼叫 getVideoPlaybackQuality() 以獲取 VideoPlaybackQuality 物件,然後確定因損壞或丟棄而丟失的幀的百分比。如果該百分比超過 10% (0.1),則呼叫一個名為 lostFramesThresholdExceeded() 的函式,以可能更新質量指示器以顯示幀丟失的增加。

js
const videoElem = document.getElementById("my_vid");
const quality = videoElem.getVideoPlaybackQuality();

if (
  (quality.corruptedVideoFrames + quality.droppedVideoFrames) /
    quality.totalVideoFrames >
  0.1
) {
  lostFramesThresholdExceeded();
}

可以使用類似的演算法嘗試切換到需要更少頻寬的較低解析度影片,以避免丟幀。

規範

規範
媒體播放質量
# dom-videoplaybackquality-totalvideoframes

瀏覽器相容性

另見

  • 用於構造和返回此介面的 HTMLVideoElement.getVideoPlaybackQuality() 方法。