HTMLVideoElement
由<video>
元素实现,HTMLVideoElement
接口提供了用于操作视频对象的特殊属性和方法。它还继承了HTMLMediaElement
和HTMLElement
的属性和方法。
各个浏览器支持的媒体格式列表有所不同。您应该以所有相关浏览器都支持的单个格式提供您的视频,或者以足够多的不同格式提供多个视频源,以涵盖您需要支持的所有浏览器。
实例属性
继承其父接口HTMLMediaElement
和HTMLElement
的属性。
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
非标准 只读 已弃用-
返回一个布尔值,指示视频是否关联了一些音频。
实例方法
继承其父接口HTMLMediaElement
和HTMLElement
的方法。
HTMLVideoElement.cancelVideoFrameCallback()
-
取消先前注册的视频帧回调(参见
requestVideoFrameCallback()
)。 HTMLVideoElement.getVideoPlaybackQuality()
-
返回一个
VideoPlaybackQuality
对象,其中包含当前的播放指标。此信息包括丢弃或损坏的帧数以及总帧数等内容。 HTMLVideoElement.requestPictureInPicture()
-
请求用户代理将视频置于画中画模式。
HTMLVideoElement.requestVideoFrameCallback()
-
注册一个回调函数,该函数在将新的视频帧发送到合成器时运行。这使开发人员能够对每个视频帧执行高效的操作。
事件
继承其父接口HTMLMediaElement
和HTMLElement
的事件。
使用addEventListener()
或通过为该接口的oneventname
属性分配事件监听器来监听这些事件。
enterpictureinpicture
-
当
HTMLVideoElement
成功进入画中画模式时触发。 leavepictureinpicture
-
当
HTMLVideoElement
成功退出画中画模式时触发。 resize
-
当
videoWidth
和videoHeight
属性中的一个或两个刚刚更新时触发。
规范
规范 |
---|
HTML 标准 # htmlvideoelement |
浏览器兼容性
BCD 表格仅在浏览器中加载