uni.createInnerAudioContext()锁屏即停,因其非系统级音频会话;iOS需manifest配置UIBackgroundModes:"audio"并云打包,Android需前台服务+WAKE_LOCK权限,合规申请后台能力才是关键。

uni-app 无法防止 App 被系统强行杀掉——它只能按平台规则申请合法的后台存活资格,越界操作只会加速被杀或导致上架失败。
为什么 uni.createInnerAudioContext() 锁屏就停
这个 API 是为页面内音效设计的,不是系统级音频会话。iOS 切后台瞬间挂起,Android 多数机型几秒内静音,连“后台播放”资格都不被系统认可。
- 调用
play()后一切正常,锁屏/切后台无声 → 典型误用uni.createInnerAudioContext() - iOS 即使加了权限也无效,因为没触发系统音频会话
- H5 端调用
uni.getBackgroundAudioManager()完全无效果,必须用条件编译隔离
iOS 必须配 UIBackgroundModes: "audio"
这不是可选项,是硬性准入门槛。没这行配置,iOS 连后台播放资格都没有,切后台立即暂停。
- 打开
manifest.json,切换到「源码视图」 - 在
"app-plus"->"distribute"->"ios"节点下添加:"UIBackgroundModes":"audio" - 值只支持小写
audio、location、fetch等有限字符串,拼错(如Audio)或填错全无效 - 改完必须重新云打包,本地调试不生效
Android 必须用前台服务 + WAKE_LOCK 权限
仅调用 uni.getBackgroundAudioManager().play() 不够,华为、小米等机型锁屏后仍会快速中断。
- 必须搭配前台服务通知(带常驻通知栏),否则系统认为你“没在认真做事”
- 需在
AndroidManifest.xml中声明WAKE_LOCK权限 - 推荐使用原生插件如
Ba-KeepAliveSuit,它封装了前台服务启动、通知创建、电池优化白名单引导等逻辑 - 单纯靠
setInterval或 WebSocket 在后台维持心跳,Android 8.0+ 几乎必死
保活不是目的,合规才是底线
2026 年 Google Play 已下架超 12 万款滥用保活机制的 App;iOS 审核对 VOIP/音频外的“伪后台”行为零容忍。所谓“持续运行”,本质是明确场景(如音乐播放、运动轨迹记录)、申请对应能力(audio 或 location)、配合系统规则最小化实现——任何试图绕过限制的方案,要么失效,要么让 App 进不了应用市场。


















