uni.getBackgroundAudioManager() 返回空或 undefined 的根本原因是平台不支持或环境配置错误：微信小程序有效，支付宝等平台返回 undefined，H5 静默失败，App 端需 manifest.json 正确配置。
uni.getBackgroundAudioManager() 返回空或 undefined
这是最常卡住的第一步：调用 uni.getBackgroundAudioManager() 后得到空对象，后续所有操作都无效。根本原因不是代码写错，而是平台不支持或环境没走对。
- 只在微信小程序中有效，支付宝、字节、快应用等平台返回
undefined或空对象，不能硬调用 - H5 端完全无实现，调用后静默失败，不报错也不生效
- App 端（iOS/Android）虽然有该 API，但必须配合
manifest.json正确配置才可用；否则返回的 manager 实例无法真正接管音频会话 - 务必加运行时判断：
const manager = uni.getBackgroundAudioManager?.() || null，再检查manager && typeof manager.play === 'function'
锁屏界面不显示封面/标题/控制条
iOS 微信锁屏界面空白或只写“未知”，不是样式问题，是元数据缺失或格式错误导致系统拒绝渲染。
-
manager.title、manager.singer、manager.epname至少填满两项，缺一不可（仅填title不够） -
manager.coverImgUrl必须是 HTTPS 地址，且尺寸 ≥ 300×300，HTTP 或本地路径（如/static/cover.jpg）在 iOS 锁屏下不显示 - 赋值顺序不能颠倒：先设
src，再设元数据，最后调play()；如果src未加载完成就设封面，iOS 可能忽略 - 微信基础库版本需 ≥ 2.19.0，低版本即使全配对也无锁屏控件
切后台后音频立即中断或无声
播放正常，一锁屏/切后台就停，说明音频会话没被系统认可为“后台可播”，本质是原生层权限未激活。
- iOS：
manifest.json中必须有"ios": {"UIBackgroundModes": ["audio"]}，注意是数组，不是字符串，且必须嵌套在app-plus.distribute下 - Android：需在
app-plus.background.mode设为"audio"，同时确保app-plus.modules.Audio为{}（启用音频模块） - 改完
manifest.json必须重新云打包，热更新和本地调试不生效；真机测试前确认打包日志含 “background audio enabled” 提示 - 不要在
onHide里手动pause()再onShow恢复——锁屏时用户点播放键，根本不会触发这些钩子
onTimeUpdate/onPlay/onPause 事件不触发或延迟严重
进度条不动、暂停状态不同步，不是监听漏了，而是事件机制本身受限于平台策略。
-
onTimeUpdate在微信小程序中约每 250ms 触发一次，不能用于高精度拖动；拖动必须用seek()+play()组合 - iOS 真机上
onPause可能延迟 300–800ms 才触发，别依赖它即时更新 UI；建议结合onStateChange（如有）或轮询manager.paused - 事件绑定必须在
play()前完成，且全局只绑一次（推荐在 App.vue 的onLaunch中初始化并缓存 manager 实例）；重复绑定会导致多次触发 - 不要混用
uni.createInnerAudioContext()和uni.getBackgroundAudioManager()—— 后者会抢占音频焦点，前者实例可能被静音或销毁
