你可以使用 media.playMusic() 函数来播放 MP3 格式的音频文件。该函数在后台异步播放音乐，不会打开任何播放界面。

基本用法

// 播放位于 /sdcard/1.mp3 的音频文件
media.playMusic('/sdcard/1.mp3');

控制播放行为

你还可以指定音量和是否循环播放：

• 音量：第二个参数为 0~1 之间的浮点数，表示播放音量。
• 循环播放：第三个参数设为 true 可循环播放。

// 以50%音量循环播放音频
media.playMusic('/sdcard/1.mp3', 0.5, true);

等待音乐播放完成

由于脚本执行完会自动停止播放，如果你希望音乐完整播放完毕，可以使用 sleep() 配合 media.getMusicDuration()：

// 播放音乐
media.playMusic('/sdcard/1.mp3');

// 获取音乐时长并等待播放完成
sleep(media.getMusicDuration());

其他常用控制函数

// 暂停播放
media.pauseMusic();

// 继续播放
media.resumeMusic();

// 停止播放
media.stopMusic();

// 跳转到指定位置（例如跳到 30 秒）
media.musicSeekTo(30 * 1000);

// 查询当前是否正在播放
if (media.isMusicPlaying()) {
    toastLog("正在播放");
}

// 获取当前播放进度
log("当前进度: " + media.getMusicCurrentPosition() + " ms");

// 获取音乐总时长
log("总时长: " + media.getMusicDuration() + " ms");

⚠️ 注意：

• 文件路径必须正确且文件存在。
• 如果文件不存在或格式不支持，会抛出 UncheckedIOException 异常。
• 若需用户可见的播放方式，可调用 app.viewFile(path) 使用系统播放器打开。

文档地址 https://docs.hamibot.com/