媒体

https://html.spec.whatwg.org/multipage/media.html#htmlmediaelement（仅提供英文版）

扩展

• React.Component

扩展自

• Audio
• Video

实现

• HTMLMediaElement

构造函数

new Media()

new Media(props, mediaPlayer): 媒体

参数

props

any

mediaPlayer

MediaPlayer

返回值

媒体

属性

preservesPitch?

optional preservesPitch: boolean | undefined

https://html.spec.whatwg.org/multipage/media.html#dom-media-preservespitch（仅提供英文版）未实现

方法

addEventListener()

addEventListener(type: string, listener: EventListener, options?: boolean | AddEventListenerOptions | undefined): void

添加事件侦听器

参数

type

string

listener

EventListener

options?

boolean | AddEventListenerOptions | undefined

---

addTextTrack()

addTextTrack(kind: TextTrackKind, label?: string | undefined, language?: string | undefined, uri?: string | undefined, mimeType?: string | undefined): TextTrack

https://html.spec.whatwg.org/multipage/media.html#dom-media-addtexttrack（仅提供英文版）

参数

kind

TextTrackKind

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

label?

string | undefined

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

language?

string | undefined

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

uri?

string | undefined

uri属性必须返回TextTrack对象所代表的文本轨道的带外字幕的uri。此项为自定义添加项（未依照w3c规范）。如果提供了uri，则此组件将负责解析和呈现字幕。

mimeType?

string | undefined

mimeType属性必须返回TextTrack对象所代表的文本轨道的带外字幕的mime类型。此项为自定义添加项（未依照w3c规范）。

返回值

TextTrack

---

canPlayType()

canPlayType(type: string): CanPlayTypeResult

https://html.spec.whatwg.org/multipage/media.html#dom-navigator-canplaytype（仅提供英文版）

参数

type

string

mime类型

返回值

CanPlayTypeResult

---

componentDidMount()

componentDidMount(): void

---

componentWillUnmount()

componentWillUnmount(): void

---

fastSeek()

fastSeek(time: number): void

https://html.spec.whatwg.org/multipage/media.html#dom-media-fastseek（仅提供英文版）

参数

time

number

---

getStartDate()

getStartDate(): Date

https://html.spec.whatwg.org/multipage/media.html#dom-media-getstartdate（仅提供英文版）

返回值

Date

---

handleEvent()

handleEvent(event: NativeInterfaces.NativeMediaElementEvent): void

处理所有媒体元素和音频/视频轨道列表事件。

参数

event

NativeInterfaces.NativeMediaElementEvent

---

load()

load(): void

---

onCaptionViewCreated()

onCaptionViewCreated(captionViewHandle: string): void

参数

captionViewHandle

string

---

pause()

pause(): void

https://html.spec.whatwg.org/multipage/media.html#dom-media-pause（仅提供英文版）

---

play()

play(): Promise<void>

https://html.spec.whatwg.org/multipage/media.html#dom-media-play（仅提供英文版）

返回值

Promise<void>

---

removeEventListener()

removeEventListener(type: string, listener: EventListener, options?: boolean | EventListenerOptions | undefined): void

移除事件侦听器

参数

type

string

listener

EventListener

options?

boolean | EventListenerOptions | undefined

---

setMediaKeys()

setMediaKeys(mediaKeys?: MediaKeys | undefined): Promise<void>

参数

mediaKeys?

MediaKeys | undefined

返回值

Promise<void>

---

Last updated: 2026年7月31日