锁屏状态下无法用 settimeout 或 setinterval 实现定时关闭音乐，因 ios 和 android 后台 js 线程被系统挂起或终止；应改用 uni.getbackgroundaudiomanager() 的 ontimeupdate 事件结合播放进度控制，并确保正确配置 wake_lock 权限及音频元信息。
锁屏状态下无法用 setTimeout 或 setInterval 实现定时关闭音乐——iOS 和 Android 后台 JS 线程都会被系统挂起或终止，定时器根本不会触发。
为什么 onUnload/onHide 里设的定时器锁屏后就失效
uni-app 的页面生命周期钩子（如 onUnload、onHide）在锁屏或切后台后立即停止执行。JS 上下文被系统冻结，所有未完成的定时器、监听器、Promise 回调全部暂停或丢弃。这不是代码没写对，是平台机制强制限制。
- iOS 上，App 进入后台后约 3–5 秒内 JS 就被挂起；超过 30 秒未响应会直接终止进程
- Android 各厂商策略更激进：华为 EMUI、小米 MIUI 常在锁屏 1–2 秒内杀掉前台服务，除非你已正确声明
WAKE_LOCK权限并启用音频会话 -
uni.startBackgroundTask在 iOS 上基本无效，返回的任务 ID 只是占位符，不代表真在运行
真正可行的方案：用音频播放器自身状态 + 后台事件驱动
必须放弃“靠 JS 定时器倒计时”的思路，改用系统级音频控制能力：监听播放进度、绑定 onTimeUpdate、结合 seek 和 pause 主动干预。关键前提是使用 uni.getBackgroundAudioManager()，且已在 manifest 中正确配置。
- 播放前设置
manager.src并调用manager.play()，确保音频会话已激活 - 在
manager.onTimeUpdate中判断当前播放时间是否达到目标时长，一旦满足立即manager.pause() - 注意
onTimeUpdate触发频率低（约 250ms 一次），别依赖它做毫秒级精度控制 - 若需“播放 30 分钟后自动关闭”，应在开始播放时记录
manager.duration，并在onTimeUpdate中持续比对manager.currentTime - 务必加
try/catch包裹pause()调用——部分机型在锁屏瞬间可能已销毁 manager 实例
Android 锁屏后 onTimeUpdate 不触发？检查 WAKE_LOCK 权限
很多项目卡在这一步：iOS 上能跑通，Android 锁屏几秒后 onTimeUpdate 就停了。根本原因不是代码问题，而是 manifest.json 里 WAKE_LOCK 权限没生效。
- 权限声明必须是字符串数组格式：
"permissions": ["<uses-permission android:name='\"android.permission.WAKE_LOCK\"'></uses-permission>"] - XML 标签必须转义，斜杠不能省略，引号必须是英文双引号
- 该配置必须放在
app-plus → distribute → android下，不能混在 iOS 配置里 - 改完必须重新云打包，本地调试和热更新完全不生效
- 真机测试前确认打包日志出现
background audio enabled提示
微信小程序端无法实现锁屏定时关闭
微信小程序平台不支持后台 JS 执行，onTimeUpdate 在锁屏/后台状态下会停止触发，且无法通过任何配置恢复。这意味着：只要用户锁屏或切换到其他 App，你的倒计时逻辑就彻底中断。
- 唯一能做的，是在用户点击播放前就预设好“最多播 30 分钟”，然后在前台时用
onTimeUpdate监控；一旦切后台，就只能放弃定时逻辑 - 支付宝、字节、快应用等平台连
onTimeUpdate后台触发都不支持，降级策略只能是：锁屏即暂停，前台恢复时提示“继续播放” - 不要尝试用
onHide记录时间戳、onShow再计算差值——用户可能锁屏 2 小时后才回来，这个差值毫无意义
最易被忽略的一点：iOS 上若 manager.title、manager.epname、manager.singer 任意两个为空，锁屏界面控件不显示，onTimeUpdate 也会被系统静默抑制——看似代码没报错，实则事件根本没注册成功。
