HTMLVideoElement

Baseline 广泛可用 *

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

* 此特性的某些部分可能存在不同级别的支持。

<video> 元素实现,HTMLVideoElement 接口提供了用于操作视频对象的特殊属性和方法。它还继承了 HTMLMediaElementHTMLElement 的属性和方法。

支持的 媒体格式 因浏览器而异。您应该提供一种所有相关浏览器都支持的单一格式的视频,或者提供多种格式的视频源,以覆盖您需要支持的所有浏览器。

EventTarget Node Element HTMLElement HTMLMediaElement HTMLVideoElement

实例属性

继承自其父接口 HTMLMediaElementHTMLElement 的属性。

HTMLVideoElement.disablePictureInPicture

指示用户代理是否应向用户建议画中画模式。

HTMLVideoElement.height

一个字符串,反映了 height HTML 属性,该属性指定显示区域的高度(以 CSS 像素为单位)。

HTMLVideoElement.poster

一个字符串,反映了 poster HTML 属性,该属性指定在没有可用视频数据时显示的图像。

HTMLVideoElement.videoHeight 只读

返回一个无符号整数值,指示资源的固有高度(以 CSS 像素为单位),如果尚无媒体可用,则为 0。

HTMLVideoElement.videoWidth 只读

返回一个无符号整数值,指示资源的固有宽度(以 CSS 像素为单位),如果尚无媒体可用,则为 0。

HTMLVideoElement.width

一个字符串,反映了 width HTML 属性,该属性指定显示区域的宽度(以 CSS 像素为单位)。

Firefox 特有属性

HTMLVideoElement.mozParsedFrames 非标准 只读 已弃用

返回一个 unsigned long,表示从媒体资源解析出的视频帧计数。

HTMLVideoElement.mozDecodedFrames 非标准 只读 已弃用

返回一个 unsigned long,表示已解码为图像的已解析视频帧计数。

HTMLVideoElement.mozPresentedFrames 非标准 只读 已弃用

返回一个 unsigned long,表示已解码并提交到渲染管线以进行绘制的帧计数。

HTMLVideoElement.mozPaintedFrames 非标准 只读 已弃用

返回一个 unsigned long,表示已在屏幕上绘制的已呈现帧计数。

HTMLVideoElement.mozFrameDelay 非标准 只读 已弃用

返回一个 double,表示最后一个绘制的视频帧延迟的时间(以秒为单位)。

HTMLVideoElement.mozHasAudio 非标准 只读 已弃用

返回一个布尔值,指示视频是否有关联的音频。

实例方法

继承自其父接口 HTMLMediaElementHTMLElement 的方法。

HTMLVideoElement.cancelVideoFrameCallback()

取消先前注册的视频帧回调(参见 requestVideoFrameCallback())。

HTMLVideoElement.getVideoPlaybackQuality()

返回一个 VideoPlaybackQuality 对象,其中包含当前的播放指标。这些信息包括丢帧或损坏帧的数量以及总帧数。

HTMLVideoElement.requestPictureInPicture()

请求用户代理将视频进入画中画模式。

HTMLVideoElement.requestVideoFrameCallback()

注册一个回调函数,当新的视频帧发送到合成器时执行。这使开发人员能够对每个视频帧执行高效的操作。

事件

继承自其父接口 HTMLMediaElementHTMLElement 的事件。

使用 addEventListener() 监听这些事件,或通过将事件监听器分配给此接口的 oneventname 属性。

enterpictureinpicture

HTMLVideoElement 成功进入画中画模式时触发。

leavepictureinpicture

HTMLVideoElement 成功退出画中画模式时触发。

resize

videoWidthvideoHeight 属性中的一个或两个刚刚更新时触发。

规范

规范
HTML
# htmlvideoelement

浏览器兼容性

另见