HTMLMediaElement
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
特性
从父级 HTMLElement
、Element
、Node
和 EventTarget
继承属性。
名称 | 类型 | 描述 | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
audioTracks |
AudioTrackList |
表示在该元素中包含的 |
||||||||||||||||||
autoplay |
Boolean |
表示 |
||||||||||||||||||
buffered 只读 |
TimeRanges |
buffered 属性会告诉浏览器哪一部分的媒体已经被下载(如果浏览器支持的话),按照标准会返回一个TimeRanges 对象
|
||||||||||||||||||
controller |
MediaController |
返回当前媒体控制器的 MediaController 对象,如果没有连接就返回 null |
||||||||||||||||||
controls |
Boolean |
映射在 HTML
标签。controls
属性控制是否显示用户播放界面的控制 HTML
|
||||||||||||||||||
crossOrigin |
DOMString |
一个表示媒体元素
CORS 设置的DOMString 。从
CORS settings attributes
查看更多详情
|
||||||||||||||||||
currentSrc 只读 |
DOMString |
用DOMString 表示媒体文件的绝对 URL。如果networkState
为EMPTY, 那么值为空字符串。
|
||||||||||||||||||
currentTime |
double |
当前播放时间,单位为秒。为其赋值将会使媒体跳到一个新的时间。 | ||||||||||||||||||
defaultMuted |
Boolean |
映射在 HTML 标签上。muted
属性表示媒体声音被播放时是否应该被静音。这个属性不能动态设置静音/不静音,如果希望设置静音/不静音,请使用
muted 属性
|
||||||||||||||||||
defaultPlaybackRate |
double |
控制媒体的播放速度。1.0 表示正常的播放速度,如果值小于
1.0,则播放速度会比”正常速度“慢,如果值大于
1.0,则播放速度会比”正常速度“快。0.0 是一个无效的值,并且会抛出
NOT_SUPPORTED_ERR 错误。
|
||||||||||||||||||
duration 只读 |
double |
媒体以秒为单位的总长度时间,如果媒体不可用,则为 0. 如果媒体可用,但时间长度未知,值为 NAN. 如果媒体是以 stream 形式传输并且没有预定长度,则值为 Inf。 | ||||||||||||||||||
ended 只读 |
Boolean |
表示媒体是否已经播放完毕。 | ||||||||||||||||||
error 只读 |
MediaError |
MediaError 对象表示最近的错误,如果没有错误则值为
null 。
|
||||||||||||||||||
initialTime 只读
非标准
已弃用
|
double |
初始播放位置(以秒为单位)。 | ||||||||||||||||||
loop |
Boolean |
会映射在 HTML 标签 loop 属性
, 决定该媒体是否循环播放。
|
||||||||||||||||||
mediaGroup |
DOMString |
反映在 HTML mediagroup
标签上。
表示元素所归属的分组,同一组的媒体元素会共享同一个控制器(controller )。
|
||||||||||||||||||
mediaKeys 实验性 只读 | MediaKeys |
Returns a reference to the MediaKeys interface,
which is a set of keys that an associated HTMLMediaElement can use for
decription of media data during playback.
|
||||||||||||||||||
mozAudioChannelType
非标准
|
DOMString |
Can be used to set the audio channel that the sound coming from an
<audio> or <video>
element will play in, on a Firefox OS device. See
Using the AudioChannels API
for more details.
|
||||||||||||||||||
mozChannels 只读
非标准
|
long |
声道数 (比如 2 是立体声). |
||||||||||||||||||
mozFrameBufferLength
非标准
|
long |
Indicates the number of samples that will be returned in the
framebuffer of each
The |
||||||||||||||||||
mozSampleRate 只读
非标准
|
long |
播放内容的采样率(每秒采样次数)。比如,44100 就是一张 CD 的采样率。 | ||||||||||||||||||
mozSrcObject
非标准
|
MediaStream |
Lets you set or get the Media Stream to be played or being played. | ||||||||||||||||||
muted |
Boolean |
静音时为 true ,否则是false . |
||||||||||||||||||
networkState |
unsigned short |
获取媒体时的网络状态
|
||||||||||||||||||
paused 只读 |
Boolean |
指示媒体元素是否被暂停。 | ||||||||||||||||||
playbackRate |
double |
The current rate at which the media is being played back. This is used to implement user controls for fast forward, slow motion, and so forth. The normal playback rate is multiplied by this value to obtain the current rate, so a value of 1.0 indicates normal speed.
If the
The pitch of the audio is corrected by default and is the same for
every speed. Some browsers implement the non-standard
|
||||||||||||||||||
played 只读 |
TimeRanges |
媒体可被播放的范围。 | ||||||||||||||||||
preload |
DOMString |
Reflects the preload HTML
attribute, indicating what data should be preloaded, if any. Possible
values are: none , metadata , auto .
See preload attribute
documentation for details.
|
||||||||||||||||||
readyState 只读 |
unsigned short |
The readiness state of the media.
|
||||||||||||||||||
seekable 只读 |
TimeRanges |
The time ranges that the user is able to seek to, if any. | ||||||||||||||||||
seeking 只读 |
Boolean |
Indicates whether the media is in the process of seeking to a new position. | ||||||||||||||||||
sinkId
只读
实验性
|
DOMString |
The unique ID of the audio device delivering output, or an empty string
if it is using the user agent default. This ID should be one of the
MediaDeviceInfo.deviceid values returned from
MediaDevices.enumeratedDevices() ,
id-multimedia , or id-communications .
|
||||||||||||||||||
src |
DOMString |
Reflects the src HTML
attribute, containing the URL of a media resource to use. Gecko
implements a similar functionality for streams:
mozSrcObject .
|
||||||||||||||||||
textTracks |
TextTrackList |
Represents the list of TextTrack objects
contained in the element.
|
||||||||||||||||||
videoTracks |
VideoTrackList |
Represents the list of VideoTrack objects
contained in the element.
Note: Yet Gecko supports only single track playback, and the parsing of tracks' metadata is only available for media with Ogg container foramt. |
||||||||||||||||||
volume |
double |
表示音频的音量。值从 0.0(静音)到 1.0(最大音量)。 |
Methods
Inherits methods from its parent, HTMLElement
.
Name & Arguments | Return | Description |
---|---|---|
canPlayType(in DOMString
type)
|
DOMString
|
Determines whether the specified media type can be played back.
Note: Previously
|
fastSeek(double time) |
void |
Directly seek to the given time. |
load() |
void |
Reset the media element and restart selecting the media resource. Any
pending events are discarded. How much media data is fetched is still
affected by the preload attribute. This method can be
useful for releasing resources after any src attribute and
source element descendants have been removed. Otherwise, it
is usually unnecessary to use this method, unless required to rescan
source element children after dynamic changes.
|
mozGetMetadata()
非标准
|
Object |
The mozGetMetadata method returns a javascript object whose
properties represent metadata from the playing media resource as {key:
value} pairs. A separate copy of the data is returned each time the
method is called.This method must be called after the loadedmetadata event fires.
|
mozLoadFrom(HTMLMediaElement other)
非标准
已弃用
|
void |
This method, available only in old Mozilla's implementation, loads data
from another media element. This works similarly to
load() except that instead of running the normal resource
selection algorithm, the source is simply set to the
other element's currentSrc .This is optimized so this element gets access to all of the other element's cached and buffered data; in fact, the two
elements share downloaded data so that data downloaded by either element
is available to both.
|
pause() |
void |
暂停播放。 |
play()
|
void |
开始播放。 |
setMediaKeys 实验性 | Promise |
Sets the MediaKeys keys to use when decrypting
media during playback.
|
setSinkId 实验性 | Promise |
Sets the ID of the audio device through which audio output should be rendered if the application is authorized to play out of a given device. |
Events
Audio and Video elements can fire quite a few different events.
Specifications
Specification |
---|
HTML Standard # htmlmediaelement |
Browser compatibility
BCD tables only load in the browser
See also
-
References
<video>
and<audio>
HTML elements.HTMLVideoElement
andHTMLAudioElement
interfaces, derived fromHTMLMediaElement
.
-
Articles