多数「护眼」功能是把调节权交给用户:拖亮度条、开夜间模式、手动切色温。光栖这个纯 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 只负责挑一档。
- export function bandOf(lux: number): LuxBand {
- if (lux < 20) { return BAND_DARK; }
- if (lux < 120) { return BAND_DUSK; }
- if (lux < 420) { return BAND_ROOM; }
- if (lux < 1200) { return BAND_WINDOW; }
- return BAND_BLAZE;
- }
复制代码
阈值不是拍脑袋定的:20 lux 以下基本是熄灯后屏幕自身的反光,120 lux 是走廊夜灯的边界,420 lux 是常见室内照明,1200 lux 往上就靠窗或直射了。全工程只有 bandOf() 一个入口,卡片辉光、环形进度渐变、强调色全部从 band().primary 与 band().secondary 取值。于是「环境光变了,整个应用的气质跟着变」这个效果只写了一次,后续改配色不必翻十几处硬编码。
二、Canvas 光场:单画布、确定性散布与视差
背景那片光不能用组件拼。几十个带 .blur() 的 Column 叠起来,模拟器帧率直接掉到二十几。光栖的做法是一块全屏 Canvas,约 45ms 重画一次:先铺底,再用三个径向渐变做呼吸式漂移,最后压一层暗角。
- for (let i = 0; i < 3; i++) {
- const angle: number = this.phase * (0.55 + i * 0.24) + i * 2.15;
- const cx: number = w * (0.5 + 0.27 * Math.sin(angle)) + this.tiltX * 34;
- const cy: number = h * (0.26 + i * 0.11) + Math.cos(angle * 0.8) * h * 0.055 + this.tiltY * 26;
- const radius: number = Math.min(w, h) * (0.44 + 0.07 * Math.sin(angle * 1.3));
- }
复制代码
三个光斑相位彼此错开,半径在 0.44–0.51 之间缓慢伸缩,观感是「光在房间里飘」而不是「圆形在位移」。所有尺寸都以 Math.min(w, h) 为基准,竖屏、折叠屏、平板都不会跑构图。
光尘有个细节:不用 Math.random(),而用黄金比例取小数做确定性散布,即 (i * 0.6180339887) % 1。随机数会让每次冷启动的星点分布都不一样,确定性散布在保证均匀的前提下,让同一片光场每次启动都眼熟。此外加速度计的两个分量被映射成 ±34px 与 ±26px 的位移,手一歪光斑整体偏一点,形成极轻的视差。
三、把亮度写回系统:对数压缩才是正解
既然已经知道房间有多亮,屏幕亮度就应当跟着走。难点在映射关系:线性映射在暗处过于敏感,强光下又永远差一口气,最终改用对数压缩。
- export function estimateBrightness(lux: number): number {
- const ratio: number = Math.log(1 + lux) / Math.log(1 + 20000);
- return Math.round(clamp(16 + ratio * 78, 12, 96));
- }
复制代码
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 自行计算进度。
- const ratio: number = Math.min(1, this.stageElapsed / current.seconds);
- const eased: number = 0.5 - 0.5 * Math.cos(Math.PI * ratio);
- this.orbScale = current.from + (current.to - current.from) * eased;
复制代码
选余弦是因为它的导数在两端为零:吸气到头、呼气到底那一瞬不会「撞墙」,这正是真实呼吸的手感。开启「屏幕随呼吸」后,每三次 tick 把 orbScale 映射成 10%–94% 的窗口亮度,整块屏幕成了真正的光源,而不只是一个画着圆的界面。
五、光志:24 段柱状图不引图表库
光志把一天切成 24 段,用 24 根柱子拼出光照曲线,点击柱子切换选中时段。没有引入任何图表库,一层 ForEach 加 layoutWeight 均分即可。
- Column()
- .height(Math.max(4, Math.round(item.lux / this.maxLux() * 104)))
- .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 替代多层模糊组件,系统级写入务必夹紧并保留恢复路径,以及任何依赖硬件的功能都要准备好无传感器时的降级方案。 |