HTMLMediaElement

https://html.spec.whatwg.org/multipage/media.html#htmlmediaelement（仅提供英文版）除了w3c规范中描述的标准事件外，此对象还会发出数量很少的自定义事件。“playbackstarted”：当MediaPlayer开始播放时发送给客户端的事件“audiofocusgranted”：当MediaPlayer在获得音频焦点后于内部恢复播放时发送给客户端的事件。“audiofocuspaused”：当MediaPlayer因暂时失去音频焦点而在内部暂停播放时发送给客户端的事件。“audiofocuslost”：当MediaPlayer因永久失去音频焦点而在内部暂停播放时发送给客户端的事件。

扩展自

• HTMLVideoElement
• HTMLAudioElement

实现

• EventTarget

构造函数

new HTMLMediaElement()

new HTMLMediaElement(): HTMLMediaElement

返回值

HTMLMediaElement

属性

audioTracks

abstract readonly audioTracks: AudioTrackList

获取音频轨道的列表。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-audiotracks。

---

autoplay

abstract autoplay: boolean

如果设置为true，则在加载URL时自动开始播放。如果设置为false，则应用必须明确调用播放才能开始播放。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-autoplay。

---

buffered

abstract readonly buffered: TimeRanges

获取内容的缓冲时间范围。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-buffered。

---

controls?

optional controls: boolean

启用或禁用媒体控件的用户界面。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-controls。

---

currentSrc

abstract readonly currentSrc: string

获取当前正在播放的媒体的源URL。https://html.spec.whatwg.org/multipage/media.html#dom-media-currentsrc（仅提供英文版）。

---

currentTime

abstract currentTime: number

获取或设置播放的当前时间。设置当前时间会导致搜索操作。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-currenttime。

---

defaultSeekIntervalInSec

abstract defaultSeekIntervalInSec: number

为远程控制媒体键按下功能“快进”或“快退”配置默认搜索间隔（以秒为单位）

---

duration

abstract readonly duration: number

获取正在播放的内容的持续时间。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-duration。

---

ended

abstract readonly ended: boolean

检查媒体播放是否已结束。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-ended。

---

error

abstract readonly error: MediaError

获取上次遇到的媒体错误。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-error。

---

mediaKeys?

abstract readonly optional mediaKeys: MediaKeys

简述

用于解密受DRM保护的内容的媒体密钥。有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-htmlmediaelement-mediakeys。

---

nodeName

abstract readonly nodeName: string

有关更多信息，请参阅https://developer.mozilla.org/en-US/docs/Web/API/Node/nodeName。

---

paused

abstract readonly paused: boolean

检查媒体播放是否已暂停。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-paused。

---

readyState

abstract readonly readyState: number

获取媒体元素的就绪状态。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-readystate。

---

seekable

abstract readonly seekable: TimeRanges

获取内容的可搜索时间范围。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-seekable。

---

seeking

abstract readonly seeking: boolean

检查媒体元素当前是否在搜索。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-seeking。

---

src

abstract src: string

设置媒体源的URL。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#location-of-the-media-resource。

---

srcObject

abstract srcObject: MediaProvider

设置源MediaProvider对象。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-srcobject。

---

textTracks

abstract readonly textTracks: TextTrackList

获取文本轨道的列表。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-texttracks。

---

videoTracks

abstract readonly videoTracks: VideoTrackList

获取视频轨道的列表。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-videotracks。

---

HAVE_CURRENT_DATA

readonly static HAVE_CURRENT_DATA: number = 2

有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-have_current_data。

---

HAVE_ENOUGH_DATA

readonly static HAVE_ENOUGH_DATA: number = 4

有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-have_enough_data。

---

HAVE_FUTURE_DATA

readonly static HAVE_FUTURE_DATA: number = 3

有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-have_future_data。

---

HAVE_METADATA

readonly static HAVE_METADATA: number = 1

有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-have_metadata。

---

HAVE_NOTHING

readonly static HAVE_NOTHING: number = 0

有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-have_nothing。

方法

addEventListener()

abstract addEventListener(type, listener, options?): void

添加事件侦听器。

参数

type

string

要侦听的事件。

listener

EventListener

事件处理程序函数。

options?

忽略。

boolean

AddEventListenerOptions

返回值

void

实现

EventTarget.addEventListener

---

addTextTrack()

abstract addTextTrack(kind, label?, language?, uri?, mimeType?): TextTrack

参数

kind

TextTrackKind

kind参数必须返回TextTrack对象所代表的文本轨道的文本轨道类型。

label?

string

label参数必须返回TextTrack对象所代表的文本轨道的文本轨道标签。

language?

string

language参数必须返回TextTrack对象所代表的文本轨道的文本轨道语言。

uri?

string

uri参数必须返回TextTrack对象所代表的文本轨道的带外字幕的uri。这是自定义添加（不是w3c规范的一部分）。如果您指定uri参数，则该组件将解析并呈现字幕。

mimeType?

string

mimeType参数必须返回TextTrack对象所代表的文本轨道的带外字幕的mime类型。这是自定义添加（不是w3c规范的一部分）。

返回值

TextTrack

简述

有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-addtexttrack。

---

pause()

abstract pause(): void

暂停播放。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-pause。

返回值

void

---

play()

abstract play(): void

开始播放。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-play。

返回值

void

---

removeEventListener()

abstract removeEventListener(type, listener, options?): void

删除事件侦听器。

参数

type

string

要侦听的事件。

listener

EventListener

要删除的事件处理程序函数。

options?

忽略。

boolean

EventListenerOptions

返回值

void

实现

EventTarget.removeEventListener

---

setMediaKeys()

abstract setMediaKeys(mediaKeys?): Promise<void>

参数

mediaKeys?

MediaKeys

有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-mediakeys。

返回值

Promise<void>

简述

设置用于解密受DRM保护的内容的媒体密钥。有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-htmlmediaelement-setmediakeys。

---

Last updated: 2025年10月2日