HTMLVideoElement - 表示 <video> 元素
HTMLVideoElement
接口提供了用于处理视频对象的特殊属性和方法。它还继承了 HTMLMediaElement
和 HTMLElement
的属性和方法。
支持的媒体格式列表因浏览器而异。您应该提供所有相关浏览器支持的单一格式的视频,或者提供足够的不同格式的多个视频源,以满足您需要支持的所有浏览器。
属性
从其祖先接口 HTMLMediaElement
和 HTMLElement
继承了属性。
HTMLVideoElement.height
一个 DOMString
,它反映了 height
HTML 属性,它以 CSS 像素为单位指定了显示区域的高度。
HTMLVideoElement.poster
一个 DOMString
,它反映了 poster
HTML 属性,它指定了在没有视频数据可用时显示的图像。
HTMLVideoElement.videoHeight
只读
返回一个 unsigned integer
,表示以 CSS 像素为单位的资源的固有高度,如果还没有可用的媒体,则返回 0
。
HTMLVideoElement.videoWidth
只读
返回一个 unsigned integer
,表示以 CSS 像素为单位的资源的固有宽度,如果还没有可用的媒体,则返回 0
。
HTMLVideoElement.width
一个 DOMString
,它反映了 width
HTML 属性,它以 CSS 像素为单位指定了显示区域的宽度。
Gecko 特有的属性
HTMLVideoElement.mozParsedFrames
只读
返回一个 unsigned long
,其中包含已从媒体资源中解析的视频帧数。
HTMLVideoElement.mozDecodedFrames
只读
返回一个 unsigned long
,其中包含已解码为图像的已解析视频帧的数量。
HTMLVideoElement.mozPresentedFrames
只读
返回一个 unsigned long
,其中包含已经呈现给渲染管道进行绘制的已解码帧的数量。
HTMLVideoElement.mozPaintedFrames
只读
返回一个 unsigned long
,其中包含在屏幕上绘制的呈现帧数。
HTMLVideoElement.mozFrameDelay
只读
返回一个 double
,其中包含上次绘制的视频帧的延迟时间,以秒为单位。
HTMLVideoElement.mozHasAudio
只读
返回一个 boolean
,指示是否存在与视频相关联的音频。
微软的扩展
HTMLVideoElement.msFrameStep()
将视频向前移动一帧或向后移动一帧。
HTMLVideoElement.msHorizontalMirror
获取或设置视频元素是否在显示中水平翻转。
HTMLVideoElement.msInsertVideoEffect()
将指定的视频效果插入媒体管道。
HTMLVideoElement.msIsLayoutOptimalForPlayback
只读
指示是否可以更有效地呈现视频。
HTMLVideoElement.msIsStereo3D
只读
确定系统是否将加载的视频源视为立体声 3-D。值设置为 true
表示源是立体 3D。
HTMLVideoElement.msZoom
控制是否修剪视频帧以适合视频显示。
方法
从其祖先接口 HTMLMediaElement
和 HTMLElement
继承了方法。
HTMLVideoElement.getVideoPlaybackQuality()
返回包含当前播放指标的 VideoPlaybackQuality
对象。此信息包括丢帧或损坏帧数以及帧总数等信息。
事件
从其父接口 HTMLMediaElement
及其祖先接口 HTMLElement
继承了方法。 使用 addEventListener()
或通过为 oneventname
属性分配事件监听器来监听这个接口的事件。
规范
规范 | 状态 | 备注 |
---|---|---|
Media Source Extensions Extensions to HTMLVideoElement 的定义 |
候选推荐 | 添加了 getVideoPlaybackQuality() 方法。 |
HTML Living Standard HTMLVideoElement 的定义 |
现行的标准 | - |
HTML5 HTMLVideoElement 的定义 |
推荐 | 初始定义。 |
桌面浏览器兼容性
特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
基础支持 | 支持 | 支持 | 4 | 9 | 10.5 | 支持 |
height | 支持 | 12 | 4 | 9 | 10.5 | 支持 |
poster | 支持 | 12 | 4 | 9 | 10.5 | 支持 |
videoHeight | 支持 | 12 | 4 | 9 | 10.5 | 支持 |
videoWidth | 支持 | 12 | 4 | 9 | 10.5 | 支持 |
width | 支持 | 12 | 4 | 9 | 10.5 | 支持 |
mozParsedFrames | 不支持 | 不支持 | 5 | 不支持 | 不支持 | 不支持 |
mozDecodedFrames | 不支持 | 不支持 | 5 | 不支持 | 不支持 | 不支持 |
mozPresentedFrames | 不支持 | 不支持 | 5 | 不支持 | 不支持 | 不支持 |
mozPaintedFrames | 不支持 | 不支持 | 5 | 不支持 | 不支持 | 不支持 |
mozFrameDelay | 不支持 | 不支持 | 5 | 不支持 | 不支持 | 不支持 |
mozHasAudio | 不支持 | 不支持 | 15 | 不支持 | 不支持 | 不支持 |
getVideoPlaybackQuality | 23 | 12 | 42 25 — 421 | 112 | 15 | 8 |
移动浏览器兼容性
特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
基础支持 | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
height | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
poster | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
videoHeight | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
videoWidth | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
width | 支持 | 支持 | 支持 | 4 | 未知 | 支持 | 支持 |
mozParsedFrames | 不支持 | 不支持 | 不支持 | 5 | 未知 | 不支持 | 不支持 |
mozDecodedFrames | 不支持 | 不支持 | 不支持 | 5 | 未知 | 不支持 | 不支持 |
mozPresentedFrames | 不支持 | 不支持 | 不支持 | 5 | 未知 | 不支持 | 不支持 |
mozPaintedFrames | 不支持 | 不支持 | 不支持 | 5 | 未知 | 不支持 | 不支持 |
mozFrameDelay | 不支持 | 不支持 | 不支持 | 5 | 未知 | 不支持 | 不支持 |
mozHasAudio | 不支持 | 不支持 | 不支持 | 15 | 未知 | 不支持 | 不支持 |
getVideoPlaybackQuality | 33 | 未知 | 支持 | 不支持 | 未知 | 30 | 不支持 |
1. 仅支持有限的白名单网站,例如 YouTube,Netflix 和其他热门流媒体网站。默认情况下,在 Firefox 42 中启用了 Media Source Extensions 时,白名单会被删除。
2. 仅适用于 Windows 8+。