uniapp安卓音乐
开发环境准备
确保已安装HBuilderX,并配置好Android开发环境(JDK、Android Studio等)。创建UniApp项目时选择默认模板或音乐类模板。
音频播放功能实现
使用uni.getBackgroundAudioManager()创建后台音频管理器,支持播放、暂停、停止等操作。需在manifest.json中声明后台运行权限:

"app-plus": {
"distribute": {
"android": {
"permissions": [
"<uses-permission android:name=\"android.permission.FOREGROUND_SERVICE\"/>"
]
}
}
}
音频文件处理
本地音频文件放入static目录,网络音频需确保URL可访问。推荐使用MP3格式以保证兼容性。示例代码:
const bgAudioManager = uni.getBackgroundAudioManager();
bgAudioManager.title = '歌曲名称';
bgAudioManager.singer = '歌手';
bgAudioManager.coverImgUrl = 'https://example.com/cover.jpg';
bgAudioManager.src = 'https://example.com/music.mp3';
权限与真机调试
在manifest.json中添加安卓权限:

"android": {
"permissions": [
"android.permission.MODIFY_AUDIO_SETTINGS",
"android.permission.READ_EXTERNAL_STORAGE"
]
}
真机调试时需手动开启应用的后台运行权限,避免系统限制导致播放中断。
界面与交互优化
使用uni.createInnerAudioContext()实现前台播放器界面,结合onPlay、onPause等事件更新UI。通过uni.onBackgroundAudioStop监听后台播放状态变化。
注意事项
- 安卓8.0以上需创建前台服务通知栏,参考UniApp插件市场相关插件。
- 网络音频需处理跨域问题,建议使用HTTPS协议。
- 测试时优先使用真机,模拟器可能存在音频支持不全的问题。






