此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

VideoPlaybackQuality.totalVideoFrames

基线 广泛可用

自 2019年3月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

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

video 容器已经被加载的媒体资源中已经被渲染播放或者被废弃的视频帧总数,本质上讲,这个总数是指没有发生播放异常问题下的数目。

示例

下面的例子想要表述的是通过已经丢弃(丢帧)或者播放异常的帧数总和占 totalVideoFrames 的比例超过 10%,则触发一个例如名为 lostFramesThresholdExceeded 的回调函数以反应我们当前视频资源丢帧已经播放异常的程度,从而帮助业务进行调整

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

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

触发回调函数后,我们可以使用一些算法来尝试切换到需要较少带宽,码率低的,较低分辨率视频,以避免丢帧。

规范

规范
Media Playback Quality
# dom-videoplaybackquality-totalvideoframes

浏览器兼容性

参见