HTMLVideoElement - 表示 <video> 元素

HTMLVideoElement 接口提供了用于处理视频对象的特殊属性和方法。它还继承了 HTMLMediaElementHTMLElement 的属性和方法。

支持的媒体格式列表因浏览器而异。您应该提供所有相关浏览器支持的单一格式的视频,或者提供足够的不同格式的多个视频源,以满足您需要支持的所有浏览器。

属性

从其祖先接口 HTMLMediaElementHTMLElement 继承了属性。

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

控制是否修剪视频帧以适合视频显示。

方法

从其祖先接口 HTMLMediaElementHTMLElement 继承了方法。

HTMLVideoElement.getVideoPlaybackQuality()

返回包含当前播放指标的 VideoPlaybackQuality 对象。此信息包括丢帧或损坏帧数以及帧总数等信息。

事件

从其父接口 HTMLMediaElement 及其祖先接口 HTMLElement 继承了方法。 使用 addEventListener() 或通过为 oneventname 属性分配事件监听器来监听这个接口的事件。

规范

规范 状态 备注
Media Source Extensions
Extensions to HTMLVideoElement 的定义
候选推荐 添加了 getVideoPlaybackQuality() 方法。
HTML Living Standard
HTMLVideoElement 的定义
现行的标准 -
HTML5
HTMLVideoElement 的定义
推荐 初始定义。

桌面浏览器兼容性

特性ChromeEdgeFirefoxInternet ExplorerOperaSafari
基础支持 支持 支持4910.5 支持
height 支持124910.5 支持
poster 支持124910.5 支持
videoHeight 支持124910.5 支持
videoWidth 支持124910.5 支持
width 支持124910.5 支持
mozParsedFrames 不支持 不支持5 不支持 不支持 不支持
mozDecodedFrames 不支持 不支持5 不支持 不支持 不支持
mozPresentedFrames 不支持 不支持5 不支持 不支持 不支持
mozPaintedFrames 不支持 不支持5 不支持 不支持 不支持
mozFrameDelay 不支持 不支持5 不支持 不支持 不支持
mozHasAudio 不支持 不支持15 不支持 不支持 不支持
getVideoPlaybackQuality2312

42

25 — 421

112158

移动浏览器兼容性

特性AndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
基础支持 支持 支持 支持4 未知 支持 支持
height 支持 支持 支持4 未知 支持 支持
poster 支持 支持 支持4 未知 支持 支持
videoHeight 支持 支持 支持4 未知 支持 支持
videoWidth 支持 支持 支持4 未知 支持 支持
width 支持 支持 支持4 未知 支持 支持
mozParsedFrames 不支持 不支持 不支持5 未知 不支持 不支持
mozDecodedFrames 不支持 不支持 不支持5 未知 不支持 不支持
mozPresentedFrames 不支持 不支持 不支持5 未知 不支持 不支持
mozPaintedFrames 不支持 不支持 不支持5 未知 不支持 不支持
mozFrameDelay 不支持 不支持 不支持5 未知 不支持 不支持
mozHasAudio 不支持 不支持 不支持15 未知 不支持 不支持
getVideoPlaybackQuality33 未知 支持 不支持 未知30 不支持

1. 仅支持有限的白名单网站,例如 YouTube,Netflix 和其他热门流媒体网站。默认情况下,在 Firefox 42 中启用了 Media Source Extensions 时,白名单会被删除。

2. 仅适用于 Windows 8+。

相关链接