查看: 444|回复: 3

鸿蒙环境光传感器开发:ArkUI 主题与窗口亮度联动

[复制链接]
发表于 6 小时前 | 显示全部楼层 |阅读模式
多数「护眼」功能是把调节权交给用户:拖亮度条、开夜间模式、手动切色温。光栖这个纯 ArkTS 工程尝试把因果链反过来——先让屏幕知道房间有多亮,再让界面自己长成那个房间该有的样子。核心逻辑只有一句话:读环境光 lux,然后同时改变配色、动态背景、屏幕窗口亮度与呼吸节奏。

落到 HarmonyOS 上需要三块能力配合:@kit.SensorServiceKit 取 lux 与色温,@kit.ArkUI 的 window 把亮度写回系统,Canvas 2D 负责那片持续流动的光场。以下按实现顺序拆解其中的方法、参数取舍与真实踩过的坑。

一、把物理量压成五档设计 token

第一版实现让颜色随 lux 线性变化,结果 60 lux 与 90 lux 肉眼毫无差别,200 lux 与 400 lux 却像换了一个 App。原因很直白:人眼对亮度近似对数响应,而「场景感」本身是离散的——烛光、黄昏、室内、窗边、烈日,本就是五种不同的心理情境。

所以 Theme.ets 里定义的不是颜色,而是「光域」:每一档带 name、mood、advice、primary、secondary、glow 六个字段,lux 只负责挑一档。
  1. export function bandOf(lux: number): LuxBand {
  2. if (lux < 20) { return BAND_DARK; }
  3. if (lux < 120) { return BAND_DUSK; }
  4. if (lux < 420) { return BAND_ROOM; }
  5. if (lux < 1200) { return BAND_WINDOW; }
  6. return BAND_BLAZE;
  7. }
复制代码

阈值不是拍脑袋定的:20 lux 以下基本是熄灯后屏幕自身的反光,120 lux 是走廊夜灯的边界,420 lux 是常见室内照明,1200 lux 往上就靠窗或直射了。全工程只有 bandOf() 一个入口,卡片辉光、环形进度渐变、强调色全部从 band().primary 与 band().secondary 取值。于是「环境光变了,整个应用的气质跟着变」这个效果只写了一次,后续改配色不必翻十几处硬编码。

二、Canvas 光场:单画布、确定性散布与视差

背景那片光不能用组件拼。几十个带 .blur() 的 Column 叠起来,模拟器帧率直接掉到二十几。光栖的做法是一块全屏 Canvas,约 45ms 重画一次:先铺底,再用三个径向渐变做呼吸式漂移,最后压一层暗角。
  1. for (let i = 0; i < 3; i++) {
  2. const angle: number = this.phase * (0.55 + i * 0.24) + i * 2.15;
  3. const cx: number = w * (0.5 + 0.27 * Math.sin(angle)) + this.tiltX * 34;
  4. const cy: number = h * (0.26 + i * 0.11) + Math.cos(angle * 0.8) * h * 0.055 + this.tiltY * 26;
  5. const radius: number = Math.min(w, h) * (0.44 + 0.07 * Math.sin(angle * 1.3));
  6. }
复制代码

三个光斑相位彼此错开,半径在 0.44–0.51 之间缓慢伸缩,观感是「光在房间里飘」而不是「圆形在位移」。所有尺寸都以 Math.min(w, h) 为基准,竖屏、折叠屏、平板都不会跑构图。

光尘有个细节:不用 Math.random(),而用黄金比例取小数做确定性散布,即 (i * 0.6180339887) % 1。随机数会让每次冷启动的星点分布都不一样,确定性散布在保证均匀的前提下,让同一片光场每次启动都眼熟。此外加速度计的两个分量被映射成 ±34px 与 ±26px 的位移,手一歪光斑整体偏一点,形成极轻的视差。

三、把亮度写回系统:对数压缩才是正解

既然已经知道房间有多亮,屏幕亮度就应当跟着走。难点在映射关系:线性映射在暗处过于敏感,强光下又永远差一口气,最终改用对数压缩。
  1. export function estimateBrightness(lux: number): number {
  2. const ratio: number = Math.log(1 + lux) / Math.log(1 + 20000);
  3. return Math.round(clamp(16 + ratio * 78, 12, 96));
  4. }
复制代码

0–20000 lux 被压进 0–1 的 ratio,再映射成 12%–96%;20 lux 到 1200 lux 的日常区间恰好落在中段,亮度滑杆不会一路冲顶。写回系统只碰一次 window:setWindowBrightness(Math.min(1, Math.max(0.06, percent / 100)))。

这里有两个容易忽略的点。其一,它只改当前窗口,不动系统设置,传 -1 即可恢复,所以敢让它跟着传感器高频刷新;其二,入参必须夹紧,0 会让屏幕全黑,用户会以为应用崩了。

四、呼吸律动:余弦缓动让屏幕跟着吸气

律动页把 4-7-8、箱式、谐振 5.5 三套节律做成呼吸球:吸气放大、屏息不动、呼气缩小。阶段推进不用动画曲线,而是一个 80ms 的 tick 自行计算进度。
  1. const ratio: number = Math.min(1, this.stageElapsed / current.seconds);
  2. const eased: number = 0.5 - 0.5 * Math.cos(Math.PI * ratio);
  3. this.orbScale = current.from + (current.to - current.from) * eased;
复制代码

选余弦是因为它的导数在两端为零:吸气到头、呼气到底那一瞬不会「撞墙」,这正是真实呼吸的手感。开启「屏幕随呼吸」后,每三次 tick 把 orbScale 映射成 10%–94% 的窗口亮度,整块屏幕成了真正的光源,而不只是一个画着圆的界面。

五、光志:24 段柱状图不引图表库

光志把一天切成 24 段,用 24 根柱子拼出光照曲线,点击柱子切换选中时段。没有引入任何图表库,一层 ForEach 加 layoutWeight 均分即可。
  1. Column()
  2. .height(Math.max(4, Math.round(item.lux / this.maxLux() * 104)))
  3. .linearGradient({ angle: 180, colors: [[this.barTop(item), 0], [this.barBottom(item), 1]] })
复制代码

柱高按当日峰值归一化,渐变色取自该小时所属光域的主色,于是「几点最亮、几点几乎熄了」一眼可读,颜色本身也携带光域信息。Math.max(4, ...) 是给凌晨那几段留的最小可见高度——0 高的柱子等于没有,用户会误以为数据缺失。每根柱子外面还套了一层等宽容器,height(106) 配合 justifyContent(FlexAlign.End) 把点击命中区撑满整段高度,因此点在柱子上方的空白也能选中那个小时,不用非得抠到几像素宽。

六、几个真踩过的坑

第一,ArkTS 里组件成员名不能和通用属性同名。最初写了 @Prop brightness、@Prop offset、@State scale,编译期全部报类型错误,只能改成 screenLevel、calibration、orbScale;@Builder valueOf() 还会和 Object.valueOf 打架,改名 valuePill 才通过编译。

第二,Scroll 的内容比视口矮时会被垂直居中,在大屏上表现为顶部一片空白,补上 constraintSize({ minHeight: '100%' }) 与 align(Alignment.Top) 才贴顶。

第三,sensor.on 的 interval 单位是纳秒,写 400 会疯狂回调,400000000 才是约 400ms。

第四,模拟器往往没有环境光传感器,onLight 根本不来,所以必须有兜底:liveSensor 为假时用一条正弦模拟曲线驱动界面,角标从「实时环境光」换成「模拟光场」,用户才不会以为应用坏了。

工程组织与小结

整个工程为纯 ArkTS 实现,逻辑集中在四处:common/Theme.ets 负责光域与色彩,components/LightBackdrop.ets 负责 Canvas 光场,components/RhythmView.ets 负责呼吸节律,pages/Index.ets 负责传感器与窗口联动。

环境光传感器这些年一直躺在手机里,多数时候只被用来自动调亮度。这个实践想说明另一种可能:同一个 lux 读数,可以同时决定配色体系、动态背景的速度与温度、屏幕窗口亮度,甚至一次呼吸的节奏。当界面不再是「等人来调」的静态面板,而是对环境有感知、又能反过来影响环境的东西,屏幕才真正从显示器变成了光源。对鸿蒙开发者而言,其中的可复用经验也很明确:物理量先离散成设计 token,性能敏感场景用单 Canvas 替代多层模糊组件,系统级写入务必夹紧并保留恢复路径,以及任何依赖硬件的功能都要准备好无传感器时的降级方案。
回复

使用道具 举报

发表于 6 小时前 | 显示全部楼层

Re: 鸿蒙环境光传感器开发:ArkUI 主题与窗口亮度联动

看完挺有启发,尤其是把 lux 先压成五档“光域”再做全局取色的思路,比线性调色更符合人对明暗的感知,也避免了到处写死颜色。Canvas 用单画布、确定性散布和轻微视差来控性能与观感,这个取舍很实在。亮度写回只改当前窗口、入参夹紧这两点也确实是容易踩的坑。 想请教两个实现细节:一是窗口亮度跟着传感器高频刷新时,有没有做节流或变化阈值判断,避免 lux 在分档边界附近抖动导致亮度跳变;二是“屏幕随呼吸”和自动亮度同时开启时,优先级怎么处理,退出页面或切后台时是否会把窗口亮度恢复。另外 24 段柱状图如果遇到某小时没有数据,是补零还是跳过,也关系到曲线观感。整体方案因果链很完整,期待后续把光志部分补完。
回复 支持 反对

使用道具 举报

发表于 6 小时前 | 显示全部楼层

Re: 鸿蒙环境光传感器开发:ArkUI 主题与窗口亮度联动

这套思路看下来挺受启发的,尤其赞同“先让屏幕知道房间有多亮”这个因果方向,很多护眼 App 做的其实是反过来,让用户自己去猜该调到多少,体验上就割裂了。 几个点印象比较深: 一是把 lux 直接压成五档设计 token 而不是连续映射。线性映射在暗部肉眼看不出差别、在亮部又跳变,这个坑说得太真实了,“场景感本身是离散的”这句我很认同。而且全工程只留 bandOf() 一个入口,配色、辉光、渐变都从 band() 取值,后面调风格不用满项目找硬编码,维护成本一下就下来了。 二是背景用单块全屏 Canvas 替换掉一堆带 blur 的组件,这个取舍很对。模拟器帧率掉到二十几那个描述我完全信,多个模糊层叠加在低端机上是真的扛不住。三个光斑相位错开加半径缓变,做出来的观感应该比单纯平移自然不少。黄金比例做确定性散布这个细节挺讲究的,随机数每次冷启动分布都不一样,用户其实会隐约觉得“怪”,确定性散布就规避了这点,还顺带省了种子管理。 三是 setWindowBrightness 只改当前窗口、传 -1 恢复、入参必须夹紧这几条,我猜都是踩过坑之后总结出来的,0 会让屏幕全黑那句提醒很有价值,新手很容易直接照搬 lux 映射结果就传进去了。 四是呼吸律动用余弦缓动,导数为零所以两端不会“撞墙”,这个解释比单纯说“顺滑”有说服力多了。 另外帖子最后光志那一段好像被截断了,渐变色取自该小时什么的部
回复 支持 反对

使用道具 举报

发表于 6 小时前 | 显示全部楼层

Re: 鸿蒙环境光传感器开发:ArkUI 主题与窗口亮度联动

这个“先让屏幕感知房间,再让界面长成房间”的方向很完整,五档光域把连续 lux 压成离散心理情境这点尤其关键,比线性配色稳得多。亮度用对数压缩、只写当前窗口且可恢复、Canvas 用黄金比例做确定性散布、呼吸用两端导数为零的余弦缓动,这几个取舍都很务实。 想交流几个边界情况:环境光监听有没有做节流和前后台注销?自动写回窗口亮度时,如果用户手动拖系统亮度,是暂停自动联动还是加一个短时覆盖?折叠屏或多窗口下,window 实例和亮度写回是否需要重新获取?另外色温既然已经取了,是只做白点或辉光微调,还是暂时没进主链路? 一个工程上的小建议:bandOf 阈值和亮度映射可以抽成可调参数,方便不同传感器量程真机回归。整体完成度很高,尤其光志不引图表库和光尘确定性散布这两个做法很讨巧。
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

指导单位

江苏省公安厅

江苏省通信管理局

浙江省台州刑侦支队

DEFCON GROUP 86025

Hacking Group 021A

旗下站点

态势感知中心

应急响应中心

红盟安全

联系我们

官方QQ群:112851260

官方邮箱:security#ihonker.org(#改成@)

官方核心成员

关注微信公众号

Archiver|手机版|小黑屋| ( 沪ICP备2021026908号 )

GMT+8, 2026-11-16 08:49 , Processed in 0.022979 second(s), 18 queries , Gzip On, Redis On.

Powered by ihonker.com

Copyright © 2015-现在.

  • 返回顶部