锁屏控制面板不显示的最常见原因是未设置title、singer、coverImgUrl三字段，iOS严格校验缺一不可；需确保manifest.json中app-plus→distribute下正确配置iOS音频权限与Android权限，并云打包生效；多端需条件编译避免误用。
uni.getBackgroundAudioManager() 没调用或没设关键字段
锁屏控制面板（iOS 锁屏界面、Android 通知栏媒体控件）不显示，最常见原因是 uni.getBackgroundAudioManager() 创建后，漏掉了 title、singer、coverImgUrl 这三个字段中的任意一个。iOS 系统严格校验这三项——缺一不可，否则直接判定“无媒体信息”，连播放状态图标都不渲染。
实操建议：
-
coverImgUrl必须是 HTTPS 地址或本地绝对路径（如/static/cover.jpg），相对路径或未打包的资源会加载失败，但无报错 - 不要在
play()前只设src就认为就绪；必须显式赋值全部三项后再调用play() - Android 端仅靠 JS 设置字段不够，但它是基础门槛；若仍不显示，需确认原生层是否启用了
MediaSession（依赖云打包时音频模块已启用）
manifest.json 权限配置写错位置或格式不对
即使代码全对，manifest.json 配置错一个层级或少一个引号，后台音频能力就完全失效。iOS 和 Android 的配置不能混在同一个对象里，且必须嵌套在 app-plus → distribute 下，不是根级或 h5 下。
实操建议：
- iOS 配置必须为：
"ios": {"UIBackgroundModes": ["audio"]}—— 注意是数组，"audio"是字符串，不能拼成"audion"或带空格 - Android 配置中
permissions是字符串数组，正确写法："permissions": ["<uses-permission android:name=\"android.permission.WAKE_LOCK\" />"]—— XML 标签要转义，结尾斜杠不能省 - 同时检查
app-plus.modules.Audio是否为{}（启用音频模块），漏掉这个，iOS 和部分 Android 机型也会静音
没重新云打包，本地调试误判成功
改完 manifest.json 后，热重载、真机调试、自定义基座都**不会生效**。系统权限必须由原生层在打包时注入，云打包日志里出现 background audio enabled 才算真正通过。
实操建议：
- 每次修改
manifest.json后，必须执行「发行 → 原生App-云打包」，不能只点「运行到手机」 - 打包完成后，在真机上卸载旧版再安装，避免系统复用旧权限缓存
- 如果打包日志里没看到音频相关提示，说明配置未被识别，立刻回头检查 JSON 结构和缩进
平台误用：H5 或非微信小程序调了后台 API
uni.getBackgroundAudioManager() 在 H5 端完全无效，调用后既不报错也不起作用；支付宝、字节等小程序平台也不支持该接口。若在多端项目中未做条件编译，就会导致“看似代码跑通，实际锁屏无声无控件”。
实操建议：
- 务必用
#ifdef MP-WEIXIN或#ifdef APP-PLUS包裹相关逻辑，H5 端降级为uni.createInnerAudioContext()（仅限前台） - 微信小程序虽支持，但必须手动设置
epname字段（iOS 锁屏控制条需要），而 App 端不需要；别把平台特有字段混用 - 测试前先确认当前运行环境：
uni.getSystemInfoSync().platform返回值是否匹配预期平台
