uni-app中状态栏背景色无法直接跟随视频封面色，需分端处理：APP端须关闭原生导航栏并动态调用uni.setNavigationBarColor；小程序端需同时传frontColor和backgroundColor；H5端不支持该API，须条件编译；自定义方案推荐canvas贴图或双层view模拟。
uni-app 里状态栏背景色没法直接“跟随”视频封面色——不是 API 不支持，是平台限制和渲染机制决定的，必须分端处理、绕过原生限制。
APP 端：必须关原生导航栏 + 动态调用 uni.setNavigationBarColor
APP 端（iOS/Android）能真正改状态栏背景色，但前提是："navigationStyle": "custom" 且 "titleNView": false 已在 pages.json 中配置。否则你传的 backgroundColor 只作用于原生导航栏区域，不触达状态栏。
- 视频封面加载完成（比如
onLoad或bindload后）再调用uni.setNavigationBarColor，不能在created或mounted就调——plus 环境还没就绪 - 颜色值必须是十六进制格式（如
#4a90e2），不能传 RGB/RGBA 字符串，否则 Android 部分机型（尤其华为 EMUI）会静默失败 - iOS 需确保
UIViewControllerBasedStatusBarAppearance为YES，否则设置无效；Android 要确认android:windowLightStatusBar权限已配（manifest.json → app-plus → android → permissions） - 别依赖
uni.getSystemInfoSync().statusBarHeight去算位置——它在 Android 上常返回 24，和实际不符；用 CSS 变量var(--status-bar-height)更稳
小程序端：frontColor 和 backgroundColor 必须同时传，且仅支持部分颜色
微信/支付宝等小程序平台允许通过 uni.setNavigationBarColor 设置状态栏背景，但有硬性约束：
- 必须同时传
frontColor（文字颜色，只支持"white"或"black"）和backgroundColor（十六进制，如"#ff6b6b"），漏一个都不生效 - 颜色太浅（如
#ffffff）或太暗（如#111111）时，文字可能不可读——需根据封面主色自动判断文字色，例如亮度时设 <code>frontColor: "white" - 不能在
onLoad立即调用，建议延迟50ms，否则微信基础库可能还没准备好窗口上下文 - H5 端完全不支持该 API，调用会报错，必须用
#ifdef MP-WEIXIN或#ifdef MP-ALIPAY包裹
自定义状态栏方案：渐变/图片色无法靠 CSS 实现，得用 canvas 贴图
如果视频封面是渐变图或带纹理，想让状态栏也呈现类似视觉效果，纯 CSS linear-gradient 在 iOS 微信里大概率断裂、闪烁，在 Android 厂商 WebView 中可能直接不可见——这是平台渲染层权限限制，不是写法问题。
- 实测最稳的替代方案：用
canvas绘制封面主色区域（取封面 DOM 的getBoundingClientRect()+getImageData()提取 dominant color），再生成一张 1×1 像素的渐变贴图，作为background-image应用到模拟状态栏<view></view> - 若不想操作 canvas，可用双层
<view></view>+transform: translateY()模拟透出效果：外层固定高度并overflow: hidden，内层用background: linear-gradient(...)并向上偏移，使渐变“露头”到状态栏区域 - 务必统一用
to bottom方向，避免某些 Android WebView 把to top渲染反向 - 所有自定义状态栏方案都需配合
padding-top: var(--status-bar-height)，否则内容会被顶进状态栏
容易被忽略的关键点：颜色提取时机和平台差异
封面色提取本身就有坑：视频还没解码完成时 DOM 可能没渲染，Image 对象的 onload 触发早于真实像素可读；iOS WebKit 下 getImageData 在跨域视频上受限；而 Android 部分 WebView 根本不支持 OffscreenCanvas。
- 推荐 fallback 策略：先用封面
<video></video>的poster属性图做颜色提取；若无 poster，则降级为封面第一帧截图（需后端预生成）；最后兜底用封面 URL 的哈希值映射固定色板 - APP 端真机测试必须用自定义基座，HBuilderX 自带模拟器不触发原生窗口 flags，测不出真实效果
- 小米 HyperOS、OPPO ColorOS 14+ 已废弃
plus.navigator.hideSystemNavigation()，状态栏和虚拟导航栏不能联动隐藏，得分开处理
