class Player

音频播放器目前支持 mp3、amr 和 wav，若需要支持更多类型，请在函数 audio_player_create 中添加解码器。

class audio.Player

Constructors

class audio.Player([state_callback])

创建一个 Player，state_callback 用于监控播放器状态，当状态发生变化时，将调用该回调函数。

UiFlow2：

Methods

Player.play(uri, pos=0, volume=-1, sync=True, verify=None)

播放音频文件。

参数:

• uri (str) – 音频文件的 uri。例如：”file:///flash/test.mp3”、”file:///sd/test.mp3”、”https://dl.espressif.com/dl/audio/ff-16b-2c-44100hz.mp3”。

• pos (int) – 开始播放的位置，单位为字节。

• volume (int) – 播放器的音量，范围为 0 - 100。-1 表示默认音量。

• sync (bool) – 是否同步播放。

• verify (str) – ssl 验证，默认为 None。

UiFlow2：

Player.play_raw(data, sample=16000, stereo=False, bits=16, pos=0, volume=-1, sync=True)

播放原始音频数据。

参数:

• data (bytes) – 原始音频数据。

• sample (int) – 音频数据的采样率。

• stereo (bool) – 音频数据是否为立体声。

• bits (int) – 音频数据的位数。

• pos (int) – 开始播放的位置，单位为字节。

• volume (int) – 播放器的音量，范围为 0 - 100。-1 表示默认音量。

• sync (bool) – 是否同步播放。

UiFlow2：

Player.play_tone(freq, time, volume=-1, sync=True)

播放音调。

参数:

• freq (int) – 音调的频率。

• time (float) – 音调的持续时间。

• volume (int) – 播放器的音量，范围为 0 - 100。-1 表示默认音量。

• sync (bool) – 是否同步播放。

UiFlow2：

Player.pause()

暂停播放器。

UiFlow2：

Player.resume()

恢复播放器。

UiFlow2：

Player.stop()

停止播放器。

UiFlow2：

Player.pos()

获取玩家的位置。

返回:

玩家的位置。

UiFlow2：

Player.set_vol(volume)

设置播放器的音量。

参数:

volume (int) – 播放器的音量，范围为 0 - 100。

UiFlow2：

Player.get_vol()

获取播放器的音量。

返回:

播放器的音量。

UiFlow2：