入门教程

MusicPlayer 音乐播放器

MusicPlayer 是音乐播放器,它可以方便地控制游戏中的音乐。

播放音乐前,需要用MusicPlayer::preload函数预加载音乐文件。对于每个音乐文件来说,这个函数只需要运行一次。

1
2
// 预加载音乐文件
MusicPlayer::preload(L"音乐文件名.wav");

添加音乐文件后,可以用 MusicPlayer::play 函数播放这个音乐。

1
2
3
4
5
6
// 播放音乐文件
MusicPlayer::play(L"音乐文件名.wav");
// 播放音乐文件,并循环 3 次
MusicPlayer::play(L"音乐文件名.wav", 3);
// 播放音乐文件,并循环播放
MusicPlayer::play(L"音乐文件名.wav", -1);

MusicPlayer 类的 playpauseresumestop这四个函数分别控制音乐的播放、暂停、继续、停止。

音乐对象的使用

另外,调用 MusicPlayer::preload 函数时,函数会返回一个音乐对象。

Tips

MusicPlayer::preload 函数可以多次调用
1
2
// 获取音乐对象
auto music = MusicPlayer::preload(L"音乐文件名.wav");

music 是一个 Music 类型的指针,Music::play 函数用来播放这个音乐。

1
music->play();

Music::play 函数可以指定循环播放次数(默认为 0),如果这个次数为 -1,它将循环播放。

1
music->play(-1);    // 循环播放音乐

Music 类的 playpauseresumestop这四个函数分别控制音乐的播放、暂停、继续、停止。

需要注意的是,MusicPlayer::preload 函数可能返回空指针,所以使用它时应进行判断。

1
2
3
4
5
6
7
8
// 获取音乐对象
auto music = MusicPlayer::preload(L"音乐文件名.wav");
// 判断指针是否为空
if (music)
{
// 播放音乐
music->play();
}