VideoPlaybackQuality：totalVideoFrames 属性

VideoPlaybackQuality 接口的 **totalVideoFrames** 只读属性返回自媒体加载以来已显示或丢弃的视频帧总数。

值

自媒体加载到 <video> 元素以来，该元素已显示或丢弃的帧总数。从本质上讲，这是该元素在没有出现任何问题的情况下 *将要呈现* 的帧数。

重新加载或替换媒体时，此值将重置。

示例

此示例调用 getVideoPlaybackQuality() 以获取 VideoPlaybackQuality 对象，然后确定因损坏或丢弃而丢失的帧的百分比。如果超过 10% (0.1)，则调用名为 lostFramesThresholdExceeded() 的函数，以（可能）更新质量指示器以显示帧丢失率的增加。

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

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

类似的算法可用于尝试切换到需要较少带宽的较低分辨率视频，以避免丢帧。

规范

规范
媒体播放质量 # dom-videoplaybackquality-totalvideoframes

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅

用于构造和返回此接口的 HTMLVideoElement.getVideoPlaybackQuality() 方法。