AudioPlayer

* AudioPlayer是实现HTMLAudioElement接口的组件，该接口可扩展HTMLMediaElement接口。

此项是一个typescript类，而非React Native组件。应用需要创建一个AudioPlayer实例，并使用它来开始缓冲内容，而无需开始播放。它不呈现媒体控件图形用户界面。应用需要构建自身的媒体控件用户界面并控制播放体验。

扩展

• MediaPlayer

构造函数

new AudioPlayer()

new AudioPlayer(audioType, audioUsage): AudioPlayer

参数

audioType?

AudioContentType | undefined

要播放的音频类型。

audioUsage?

AudioUsageType | undefined

播放音频的原因

返回值

AudioPlayer

方法

deinitialize()

deinitialize(): Promise<void>

取消播放器初始化。

返回值

Promise<void>

将在播放器取消初始化时解析的Promise。

---

deinitializeSync()

deinitializeSync(timeoutInMs: number): MediaPlayerDeInitStatus

同步取消播放器初始化

参数

timeoutInMs

number

客户端设置的超时阈值，用于返回deinit控件。

返回值

MediaPlayerDeInitStatus

MediaPlayerDeInitStatus

---

initialize()

initialize(): Promise<void>

初始化播放器。等待Promise履行，然后再调用任何其他函数。

返回值

Promise<void>

将在播放器初始化时解析的Promise。

---

setMediaControlFocus()

setMediaControlFocus(componentInstance: IComponentInstance, mediaControlHandler?: any): Promise<void>

使用当前正在使用的媒体播放器设置组件实例，然后传递mediaControlHandler，以防客户端想要选择处理mediacontrol命令。

参数

componentInstance

IComponentInstance

mediaControlHandler?

any

返回值

Promise<void>

---

Last updated: 2026年7月22日