音频播放器模块/AudioPlayer

此模块可以播放音频文件
传输文件
通过USB 传输mp3格式的音频文件到模块内,文件名需要以’001’,’002’这样的数字序号开头

播放

AudioPlayer.play()
如果是上电后直接调用此函数会播放导入的第一首音乐
如果是暂停之后调用此函数则会继续播放

Examples

# 播放音乐名为001的音乐,播放5秒后暂停,5秒后继续播放
from wonderbits import AudioPlayer
import time
audioPlayer1 = AudioPlayer()

audioPlayer1.play_by_name('001')
time.sleep(5)
audioPlayer1.pause()
time.sleep(5)
audioPlayer1.play()
time.sleep(5)

播放指定音乐

AudioPlayer.play_by_name(name='001xxx')
参数为音乐名,前三个字符必须是该音乐的文件名序号
参数:name (str) – 音乐名

Examples

未提供。可参考 play 的使用案例

暂停

AudioPlayer.pause()
将正在播放的歌曲暂停

Examples

未提供。可参考 play 的使用案例

下一首

AudioPlayer.next()
播放下一首音乐

Examples

# 播放音乐,当按下control1的sw1播放下一首,按下sw2播放上一首
from wonderbits import AudioPlayer, Control
import time

control1 = Control()
audioPlayer1 = AudioPlayer()

while True:
    if control1.is_sw1_pressed():
        audioPlayer1.next()
    if control1.is_sw2_pressed():
        audioPlayer1.previous()
    time.sleep(0.5)

上一首

AudioPlayer.previous()
播放上一首音乐

Examples

未提供。可参考 next 的使用案例

设置音量

AudioPlayer.set_volume(volume)
设置播放音乐的音量
参数:volume (int) – 音量:0~100

Examples

# 播放音乐名为001的音乐,播放5秒后暂停,5秒后继续播放
from wonderbits import AudioPlayer
import time
audioPlayer1 = AudioPlayer()

audioPlayer1.play_by_name('001')
time.sleep(5)
audioPlayer1.set_volume(10)
time.sleep(5)
audioPlayer1.set_volume(70)
time.sleep(5)
audioPlayer1.set_volume(20)
time.sleep(5)

获取当前音乐名

AudioPlayer.get_name()
获取正在播放的音乐名称
返回:
返回类型:str

Examples

# 播放音乐,在display1上显示播放音乐的名字
from wonderbits import AudioPlayer, Display
import time

display1 = Display()
audioPlayer1 = AudioPlayer()

audioPlayer1.play()
time.sleep(1)
display1.print(1, 1, audioPlayer1.get_name())

获取播放进度

AudioPlayer.get_progress()
获取正在播放音乐的播放进度
返回:播放进度的百分比,范围0~100
返回类型:int

Examples

# 播放音乐,在display1上显示播放音乐的名字
from wonderbits import AudioPlayer, Display

display1 = Display()
audioPlayer1 = AudioPlayer()

audioPlayer1.play()
while True:
    display1.print(1, 1, audioPlayer1.get_progress())

重新播放

AudioPlayer.replay()
如果正在播放的音乐调用此函数会重新播放该音乐
如果当前没有播放音乐调用此函数会播放之前播放的一首

Examples

# 播放音乐,在display1上显示播放音乐的名字
from wonderbits import AudioPlayer
import time

audioPlayer1 = AudioPlayer()

audioPlayer1.play()
time.sleep(10)
audioPlayer1.replay()

设置播放模式

AudioPlayer.set_mode(mode)
设置播放器的播放模式
参数:mode (int) –

播放模式

LOOP_PLAY: 循环播放
SINGLE_LOOP: 单曲循环
RANDOM_PLAY: 随机播放
SINGLE_PLAY: 单曲播放

Examples

当播放完成时

AudioPlayer.when_playing_finished()
当播放完成时,执行被修饰的函数

Examples

# 当audioPlayer1播放完成会在display1模块中显示 end

from wonderbits import AudioPlayer,Display

display1 = Display()
audioPlayer1 = AudioPlayer()

audioPlayer1.play()
display1.print(1, 1, 'start')

@audioPlayer1.when_playing_finished()
def run1(val):
    display1.print(1, 1, 'end')

while True:
    pass

事件源

AudioPlayer.AudioPlayer.source_song_index

song_index事件源