uni-app无法自动识别图片明暗，状态栏文字色需人工预设阈值或色值；app端可用uni.setnavigationbarcolor({style: 'black'/'default'})，小程序/h5不支持style参数，须用自定义导航栏+css控制，android需配置权限，ios需开启uiviewcontrollerbasedstatusbarappearance。
不能靠图片自动判断，必须人工设定临界点或预设色值。uni-app 没有图像分析能力，所谓“自动”其实是根据滚动位置、背景明暗度阈值或预设状态做映射。
uni.setNavigationBarColor 的 style 参数只在 App 端生效
小程序和 H5 完全不支持 style 字段控制状态栏文字颜色。你在微信小程序里调用 uni.setNavigationBarColor({ style: 'black' })，真机上毫无反应——不是代码写错，是平台根本不认这个参数。
-
style只接受"default"（浅色文字）或"black"（深色文字），iOS 13+ / Android 6.0+ 才识别 - 必须配合
backgroundColor使用，否则部分安卓机型（如华为 EMUI）会忽略style - 不能在
onLoad立即调用，建议延迟 100ms 或放在onReady后执行 - iOS 需确保原生工程中
UIViewControllerBasedStatusBarAppearance设为YES，否则 JS 设置无效
小程序端只能靠胶囊按钮位置 + 人工配色逻辑
微信小程序没有状态栏颜色 API，但可以通过 wx.getMenuButtonBoundingClientRect() 获取右上角胶囊按钮的 top 值，再结合你已知的背景图明暗区域，手动决定文字颜色。
- 先在
pages.json中设"navigationStyle": "custom"，让--status-bar-height可用 - 在页面
onLoad或onReady中调用wx.getMenuButtonBoundingClientRect()，拿到top（即状态栏高度 + 胶囊上边距） - 若背景图顶部区域偏暗（比如深蓝/黑渐变），就设导航栏文字为白色；若顶部偏亮（如浅灰/白图），就设为黑色
- 文字颜色通过 CSS 控制：用
color: #fff或color: #000写在自定义导航栏内，而非调用 API
App 端滚动时联动状态栏文字色需配合背景透明度变化
单纯监听 onPageScroll 改 style 是无效的——style 不支持动态插值，只能切换离散值。真正可行的是：把状态栏文字色变化和导航栏背景透明度/叠加色绑定在同一滚动阈值上。
- 例如：滚动
scrollTop 时，设 <code>uni.setNavigationBarColor({ style: 'black', backgroundColor: 'rgba(255,255,255,0)' }) -
scrollTop >= 160时，设{ style: 'default', backgroundColor: '#ffffff' } - 中间过渡段（80–160px）避免插值，用 if-else 分段，防止某些安卓机型反复重绘失败
- 注意：Android 需在
manifest.json → app-plus → android → permissions中确认是否启用android.windowLightStatusBar权限
图片背景明暗判断必须提前约定，不能运行时分析
别想着用 canvas 读取像素或调用后端 OCR——uni-app 小程序环境不支持 canvas getImageData，App 端也因沙箱限制无法可靠读图。所有“根据背景图自动切换”的实现，本质都是人定规则：
- 设计阶段就标注：该图顶部 44px 区域属于“暗区”，对应文字用白色
- 在页面 data 里写死
statusBarStyle: 'default'或'black'，由业务逻辑决定，而非图片本身 - 如果要用渐变图，把最暗/最亮色值作为 fallback：
backgroundImage: "linear-gradient(to bottom, #000000, #ffffff)"→ 暗端配白字，亮端配黑字 - 上线前务必在 iOS 真机、华为/小米/OPPO 安卓机上逐个验证，厂商定制系统对状态栏控制差异极大
