HTMLVideoElement

在此页

特性
方法
事件
规范
浏览器兼容性
另请参阅
相关话题

HTMLVideoElement interface provides special properties and methods for manipulating video objects. It also inherits properties and methods of HTMLMediaElement and HTMLElement .

列表 supported media formats varies from one browser to the other. You should either provide your video in a single format that all the relevant browsers supports, or provide multiple video sources in enough different formats that all the browsers you need to support are covered.

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 23.333333333333332%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 140" preserveAspectRatio="xMinYMin meet"><a xlink:href="../API/EventTarget.html" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25  236,20  236,30  226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25  351,20  351,30  341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25  501,20  501,30  491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="../API/HTMLMediaElement" target="_top"><rect x="331" y="65" width="160" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="411" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLMediaElement</text></a><polyline points="331,89  321,84  321,94  331,89" stroke="#D4DDE4" fill="none"/><line x1="321" y1="89" x2="291" y2="89" stroke="#D4DDE4"/><a xlink:href="../API/HTMLVideoElement" target="_top"><rect x="131" y="65" width="160" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="211" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLVideoElement</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

特性

Inherits properties from its ancestor interfaces, HTMLMediaElement ，和 HTMLElement .

HTMLVideoElement.height: 是 DOMString that reflects the height HTML attribute, which specifies the height of the display area, in CSS pixels.
HTMLVideoElement.poster: 是 DOMString that reflects the poster HTML attribute, which specifies an image to show while no video data is available.
HTMLVideoElement.videoHeight 只读
HTMLVideoElement.videoWidth 只读
HTMLVideoElement.width: 是 DOMString that reflects the width HTML attribute, which specifies the width of the display area, in CSS pixels.

Gecko-specific properties

HTMLVideoElement.mozParsedFrames 只读: 返回 unsigned long with the count of video frames that have been parsed from the media resource.
HTMLVideoElement.mozDecodedFrames 只读: 返回 unsigned long with the count of parsed video frames that have been decoded into images.
HTMLVideoElement.mozPresentedFrames 只读: 返回 unsigned long with the count of decoded frames that have been presented to the rendering pipeline for painting.
HTMLVideoElement.mozPaintedFrames 只读: 返回 unsigned long with the count of presented frames which were painted on the screen.
HTMLVideoElement.mozFrameDelay 只读: 返回 double with the time which the last painted video frame was late by, in seconds.
HTMLVideoElement.mozHasAudio 只读: 返回 boolean indicating if there is some audio associated with the video.

Microsoft Extensions

HTMLVideoElement.msFrameStep()
HTMLVideoElement.msHorizontalMirror
HTMLVideoElement.msInsertVideoEffect()
HTMLVideoElement.msIsLayoutOptimalForPlayback 只读
HTMLVideoElement.msIsStereo3D 只读
HTMLVideoElement.msZoom

方法

继承方法来自其父级 HTMLMediaElement , and from its ancestor HTMLElement .

HTMLVideoElement.getVideoPlaybackQuality(): 返回 VideoPlaybackQuality object that contains the current playback metrics. This information includes things like the number of dropped or corrupted frames, as well as the total number of frames.

事件

继承方法来自其父级 HTMLMediaElement , and from its ancestor HTMLElement . 监听这些事件使用 addEventListener() 或通过把事件监听器赋值给 on eventname 特性为此接口。

规范

规范	状态	注释
HTML 实时标准 The definition of 'HTMLVideoElement' in that specification.	实时标准

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`HTMLVideoElement`	Chrome Yes	Edge 12	Firefox 4	IE 9	Opera 10.5	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`cancelVideoFrameCallback` 非标	Chrome 83	Edge 83	Firefox No	IE No	Opera 69	Safari No	WebView Android 83	Chrome Android 83	Firefox Android No	Opera Android No	Safari iOS No	Samsung Internet Android No
`getVideoPlaybackQuality`	Chrome 80	Edge 12	Firefox 42 42 不支持 25 — 42 Disabled Limited support to an allowed list of sites, for example YouTube, Netflix, and other popular streaming sites. The limitation was removed when Media Source Extensions was enabled by default in Firefox 42. Disabled preference. To change preferences in Firefox, visit about:config.	IE 11 11 Only works on Windows 8+.	Opera 67	Safari 8	WebView Android 80	Chrome Android 80	Firefox Android No	Opera Android No	Safari iOS No	Samsung Internet Android No
`height`	Chrome Yes	Edge 12	Firefox 4	IE 9	Opera 10.5	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`mozDecodedFrames` 弃用非标	Chrome No	Edge No	Firefox 5	IE No	Opera No	Safari No	WebView Android No	Chrome Android No	Firefox Android 5	Opera Android No	Safari iOS No	Samsung Internet Android No
`mozFrameDelay` 弃用非标	Chrome No	Edge No	Firefox 5	IE No	Opera No	Safari No	WebView Android No	Chrome Android No	Firefox Android 5	Opera Android No	Safari iOS No	Samsung Internet Android No
`mozHasAudio` 弃用非标	Chrome No	Edge No	Firefox 15	IE No	Opera No	Safari No	WebView Android No	Chrome Android No	Firefox Android 15	Opera Android No	Safari iOS No	Samsung Internet Android No
`mozPaintedFrames` 弃用非标	Chrome No	Edge No	Firefox 5	IE No	Opera No	Safari No	WebView Android No	Chrome Android No	Firefox Android 5	Opera Android No	Safari iOS No	Samsung Internet Android No
`mozParsedFrames` 弃用非标	Chrome No	Edge No	Firefox 5	IE No	Opera No	Safari No	WebView Android No	Chrome Android No	Firefox Android 5	Opera Android No	Safari iOS No	Samsung Internet Android No
`mozPresentedFrames` 弃用非标	Chrome No	Edge No	Firefox 5	IE No	Opera No	Safari No	WebView Android No	Chrome Android No	Firefox Android 5	Opera Android No	Safari iOS No	Samsung Internet Android No
`msIsStereo3D` 非标	Chrome No	Edge 12 — 79	Firefox No	IE 10	Opera No	Safari No	WebView Android No	Chrome Android No	Firefox Android No	Opera Android No	Safari iOS No	Samsung Internet Android No
`poster`	Chrome Yes	Edge 12	Firefox 4	IE 9	Opera 10.5	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`requestVideoFrameCallback` 非标	Chrome 83	Edge 83	Firefox No	IE No	Opera 69	Safari No	WebView Android 83	Chrome Android 83	Firefox Android No	Opera Android No	Safari iOS No	Samsung Internet Android No
`videoHeight`	Chrome Yes	Edge 12	Firefox 4	IE 9	Opera 10.5	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`videoWidth`	Chrome Yes	Edge 12	Firefox 4	IE 9	Opera 10.5	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`width`	Chrome Yes	Edge 12	Firefox 4	IE 9	Opera 10.5	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes

图例

完整支持
不支持
实验。期望将来行为有所改变。
非标。预期跨浏览器支持较差。
弃用。不要用于新网站。

用户必须明确启用此特征。

另请参阅

元数据

最后修改： Feb 22, 2020

在此页

特性

Gecko-specific properties

Microsoft Extensions

方法

事件

规范

浏览器兼容性

图例

另请参阅

相关话题