查看: 155|回复: 3

ArkUI鸿蒙PC工作台:Canvas软光栅与断点适配

[复制链接]
发表于 1 小时前 | 显示全部楼层 |阅读模式
在鸿蒙PC的2in1形态上,原文作者做了一个刻意加限制的实验:开发三维重建工作台“澜境 · Gaussian Studio”,包名为com.lanjing.gaussianstudio,不使用原生库、不引第三方依赖、不带模型文件。最终entry-default-signed.hap约482 KB,base_native_libs.json里的libs为空,工程级与模块级oh-package.json5的dependencies都是空对象,源码只import了@kit.AbilityKit、@kit.ArkUI、@kit.PerformanceAnalysisKit三个系统Kit。

需要先明确边界:这是界面与交互原型,不是能产出高斯模型的重建引擎。视口里旋转的点云,是约2.7万个点逐帧投影后的视觉效果;界面上的1.24M Gaussians、PSNR 31.8 dB、SSIM 0.961、LPIPS 0.083、本机NPU加速、第30,000次迭代完成等均为演示占位文案。真正可复用的是窗口断点、鼠标滚轮、悬停反馈、高分屏换算、布局层级、状态流转、任务取消与清理等桌面交互做法。下面按这些可落地环节展开。

一、先把deviceTypes声明为2in1

适配桌面,第一步不是写布局,而是写声明。工程在entry/src/main/module.json5中把deviceTypes设为2in1,让系统从分发阶段就按桌面应用对待:
  1. deviceTypes: ['2in1']
复制代码

这条声明有三层影响。第一是分发:HAP面向桌面,窗口行为不再受手机窄屏逻辑约束。第二是代价:同一个包不要指望直接装到手机上,这不是bug,而是契约;要么补deviceTypes,要么接受单端分发。第三是架构提示:既然包只服务桌面,就不必为兼容手机而把面板堆叠成抽屉,也不必为触摸扩大命中区,省下的复杂度可以还给视口。

排查安装失败时,原文给出两个常见原因:签名配置与bundleName绑定,换机器或换调试证书后必须重新签名;设备上已有同bundleName的旧包时,versionCode更高会拒绝降级安装,此时先卸载旧版再装。

二、断点不要两套链路:手写windowWidth与三态布局

工程没有用GridRow、SideBarContainer或媒体查询,而是根容器量自身宽度,写入@State windowWidth,再用两个阈值决定面板去留:窗口宽度大于等于1180 vp时显示左侧226 vp项目栏;大于等于950时保留右侧288 vp检查器;中间视口始终layoutWeight(1),顶栏固定58 vp,状态栏固定25 vp。窗口拖宽只让中间画布变宽,两侧面板不动。
  1. if (this.windowWidth >= 1180) {
  2.   ProjectSidebar({ ... })
  3.     .width(226)
  4.     .height('100%')
  5. }
复制代码
  1. .onAreaChange((oldArea: Area, newArea: Area) => {
  2.   this.windowWidth = Number(newArea.width);
  3. })
复制代码

原文不建议直接套响应式容器,理由有三个。其一,断点必须和画布测量同源。视口像素尺寸依赖窗口宽度,如果布局走容器栅格、画布走onAreaChange,两条链路会在某个宽度上打架,出现面板已收起、画布还按老尺寸画的一帧鬼影。手写断点让两者共用windowWidth。其二,行为可预测,阈值不会因框架版本升级换默认断点而悄悄改变。其三,阈值会散落,所以工程把分类逻辑收敛成纯函数:
  1. export type PcLayoutMode = 'triple' | 'double' | 'single';
  2. export function layoutModeOf(widthVp: number): PcLayoutMode {
  3.   if (widthVp >= 1180) {
  4.     return 'triple';
  5.   }
  6.   if (widthVp >= 950) {
  7.     return 'double';
  8.   }
  9.   return 'single';
  10. }
复制代码

这个函数没有系统Kit依赖,属于平台无关逻辑。验收断点时,测试点不是两个,而是四个:以1180为例,拖到1181看三栏完整,拖到1179看侧栏消失时中间画布是否突然变宽,拖回1180看是否复原,再拖到恰好950看检查器是否在边界闪一下。多数断点bug只出现在刚好等于阈值的那一像素上。

三、滚轮缩放必须做指数映射

桌面用户默认滚轮能缩放。鸿蒙PC上接住滚轮的不是手势,而是轴事件。工程在Canvas上同时处理PanGesture与onAxisEvent:PanGesture用于平移或旋转,onAxisEvent读取垂直轴值并调用setZoom。
  1. .onAxisEvent((event: AxisEvent) => {
  2.   const delta = event.getVerticalAxisValue();
  3.   this.setZoom(this.camera.zoom * Math.exp(-delta * 0.08));
  4. })
复制代码

如果写成zoom + delta * 0.05,会出现两个极端:小幅滚动几乎没反应,大幅滚动一下冲到最近处。指数映射zoom * exp(-delta * 0.08)是乘法语义,当前放大倍数越高,一格滚轮的绝对位移越大,但相对变化率恒定,更符合人对缩放的感知。配合setZoom把结果钳制到[0.55, 2.4]、俯仰角钳制到[-1.15, 1.15],可同时解决滚过头穿模和缩到看不见。

原文也提醒,这套参数来自手感而非公式。不同鼠标或触控板的轴事件单位与正负方向并不保证一致,换设备后要先把-delta的符号和0.08这个系数各试一次,确认向上滚是放大。旋转手势中,工程使用offsetX * 0.008和offsetY * 0.006,并对pitch做上下限钳制。

四、悬停与键盘:桌面可信度来自反馈链

手机UI没有悬停态,因为手指能摸到就是能点。鼠标不同,用户靠扫视和悬停判断这一列图标是不是工具。工程把悬停抽进通用按钮组件,让二十多个按钮共享同一套反馈:
  1. .backgroundColor(this.selected ? StudioColors.accentSoft : this.hovered ? StudioColors.hover : Color.Transparent)
  2. .onHover((inside: boolean) => {
  3.   this.hovered = inside;
  4. })
复制代码

这里的状态优先级是selected > hovered > default,顺序不能反。如果悬停优先,鼠标一移上去,当前选中的工具就看不出被选中。原文还指出,将来若加disabled,它应排在selected之前,因为不可用的东西不该显示选中色。把优先级写进一个组件,而不是给每个按钮各写一份onHover,是保持桌面界面一致的低成本做法。

键盘是原文作者按体检表补的最小实现,不在配套工程源码中。桌面重度用户习惯Tab走焦点、Enter确认,专业工具再配单键快捷键。最小实现可在通用按钮组件里加focusable、onFocus、onBlur与onKeyEvent:
  1. .focusable(true)
  2. .onKeyEvent((event: KeyEvent) => {
  3.   if (event.type === KeyType.Down && (event.keyCode === 2054 || event.keyCode === 2062)) {
  4.     this.onAction();
  5.     return true;
  6.   }
  7.   return false;
  8. })
复制代码

onKeyEvent的返回值很容易被忽略:返回true表示按键已被消费,不再向上冒泡。如果一律return false,空格键会同时触发按钮和页面滚动;如果一律return true,Tab焦点轮转会失效。正确做法是只对确认过的按键返回true,其余交给框架。快捷键层建议放在page级,用“键码到动作”的映射表分发,而不是每个组件各自监听。关键点是键盘和滚轮不能各改一套相机参数,所有输入最终都要汇到同一个改状态的函数,否则用户滚一下再按一下+,视角会跳。

五、高分屏:vp当像素用一定糊

鸿蒙PC常接高DPI显示器。如果直接用onAreaChange给出的vp数值作为画布像素尺寸,绘制的点云会偏小、边缘发虚,缩放后更明显。工程的处理分两半:画布尺寸按vp2px换算成物理像素,绘制上下文单位显式声明为PX。
  1. const density = this.getUIContext().vp2px(1);
  2. this.widthPx = Number(newArea.width) * density;
  3. this.heightPx = Number(newArea.height) * density;
复制代码
  1. this.context = new CanvasRenderingContext2D(this.settings, LengthMetricsUnit.PX);
复制代码

两条链路必须成对出现。只换算尺寸不改单位,等于用vp数字去操作按px解释的上下文,结果反而更偏;只改单位不换算尺寸,画布只有左上角一小块被画到。这是“一个bug由两行代码共同负责”的案例,改动时要同时看这两处。

原文还给出一个性能推论:物理像素面积随密度平方增长。同样1200 vp宽的视口,在2倍屏上的可绘制像素是1倍屏的四倍,逐点绘制成本也接近四倍。所以同一应用在笔记本和4K显示器上表现不同,不是幻觉,是像素账本变了。这也是交互期间需要留降采样位置的原因。

六、一块Canvas 2D如何伪装三维:确定性、预算与参数化

在无GPU通道前提下,视口能跑起来靠三条取舍。第一,确定性优于随机性。点云由线性同余发生器生成,种子固定为该器形编号,瓶用7319,因此每次进入页面、切换着色模式、改变窗口宽度,点云都是同一朵。
  1. class SeededRandom {
  2.   private seed: number;
  3.   constructor(seed: number) {
  4.     this.seed = seed;
  5.   }
  6.   next(): number {
  7.     this.seed = (this.seed * 1664525 + 1013904223) % 4294967296;
  8.     return this.seed / 4294967296;
  9.   }
  10. }
复制代码

第二,能预算的都预算。每个点需要物体色、法线色、置信度热力色三种颜色。如果在逐点循环里用模板字符串拼rgb(),三万点每帧就是九万次字符串拼接,比绘制本身还贵。工程在addPoint()阶段就把三种颜色算成字符串存进点结构,循环里只做一次选择。点结构包含x、y、z、size、alpha、depth、color、normalColor、heatColor等字段。

第三,把美术资源换成数学。没有模型文件,器形由分段函数定义。以青釉弦纹瓶为例,五段半径函数描述瓶底、腹、肩、颈、口轮廓,再叠两层三角函数做弦纹与拉坯环纹,最后用余弦模拟固定方向主光。瓶使用种子7319生成26500个点;盏由createBowl()生成约2.71万点;兽由六个椭球组合成约2.95万点,三件器形全部运行时现算。原文强调,参数化造型的调试体验比在建模软件里反复导出.ply快不止一个数量级:改瓶颈粗细只改一个系数重跑,换器形复制函数改五段值。

一帧render()固定按七步走,顺序不能换:清屏、径向渐变背景、透视地面网格、阴影椭圆、相机旋转求深度、深度排序、逐点投影绘制。核心循环先根据yaw和pitch计算每个点的depth,再用depth升序排序,最后逐点做旋转、透视缩放和屏幕坐标映射。视口没有底图、没有贴图,背景渐变、地面网格、阴影椭圆都由同一块CanvasRenderingContext2D每帧绘制。

七、把桌面适配拆成可验收的七项

原文把鸿蒙PC桌面差异收敛为七项体检,核心价值在于每一项都能用一句动作验收,而不是“感觉不够桌面”。从上面代码可以还原出主要验收动作:窗口从宽拖到窄,检查三栏、两栏、单栏切换;在阈值两侧和恰好等于阈值处试布局;用滚轮试缩放方向、幅度和边界;把鼠标停在图标上看选中、悬停、默认三态反馈;接高分屏检查点云边缘是否发虚;用Tab和Enter检查焦点与确认;同时观察三块信息区更新时是否只换数据、不重建窗口。

这套做法的可迁移点不是某个数值,而是约束:声明先限定设备形态,断点与画布共用同一宽度来源,输入统一汇入setZoom,悬停优先级固化在通用组件,高分屏换算与上下文单位成对出现,点云颜色预计算并把造型参数化。对于鸿蒙PC上的ArkUI/ArkTS应用,这些都比“找一个大而全的库”更早决定体验是否像桌面软件。
回复

使用道具 举报

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

Re: ArkUI鸿蒙PC工作台:Canvas软光栅与断点适配

这篇挺实在,边界交代得很清楚,尤其是先声明2in1和断点同源这两点。桌面适配里布局和画布各走一条测量链路确实容易在阈值附近闪一帧,用windowWidth统一驱动、再把layoutModeOf抽成纯函数,验收点也具体,这个做法很稳。滚轮用指数映射、悬停状态优先级selected大于hovered也抓得准。想请教一下,onAreaChange量到的宽度在高分屏缩放下直接按vp用于Canvas换算会不会有偏差?另外演示占位数据如果能在界面上加个“示意”标识,后续接手的人会更不容易误解。整体是很有参考价值的交互原型拆解。
回复 支持 反对

使用道具 举报

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

Re: ArkUI鸿蒙PC工作台:Canvas软光栅与断点适配

这篇分享很实在,先把边界讲清楚很重要:这是桌面交互原型,不是能产出高斯模型的重建引擎,演示占位文案和真实能力分开说,避免了误导。可复用的部分也抓得准,2in1声明、手写windowWidth三态断点、Canvas上的指数滚轮映射、悬停与选中态优先级,都是鸿蒙PC工作台里很容易踩坑的地方。 尤其赞同断点验收按四个点测,包括刚好等于阈值的边界像素;很多布局问题确实只在那一像素上闪一下。layoutModeOf 收敛成纯函数也很稳,后面做边界单测会方便。滚轮用乘法语义比线性加减更符合缩放手感,不过换鼠标或触控板后重新确认轴向和系数这点也提醒得好。整体看,这套做法对做桌面端 ArkUI 交互原型挺有参考价值。
回复 支持 反对

使用道具 举报

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

Re: ArkUI鸿蒙PC工作台:Canvas软光栅与断点适配

这篇把边界说得很清楚,先说明是界面与交互原型而不是能产出高斯模型的重建引擎,这点很重要,能避免读者被演示占位指标带偏。2in1 的 deviceTypes 声明、手写 windowWidth 做三态断点、在 Canvas 上接轴事件做指数缩放,以及悬停态优先级,都是鸿蒙 PC 桌面适配里很实在的落脚点。尤其断点与画布测量同源这一点,能解释不少拖拽窗口时面板和视口不同步的怪问题;验收时盯 1180、950 两侧而不是只测远距离宽度,也很值得借鉴。滚轮用乘法语义符合缩放直觉,但换鼠标或触控板后先确认轴方向和系数,这个提醒很实用。末尾提到 disabled 的优先级排序,感觉是很容易漏的细节;如果后面继续补任务取消、清理和 disabled 态,应该会更完整。整体上,作为不引第三方依赖的桌面交互原型,这个拆解很有参考价值。
回复 支持 反对

使用道具 举报

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

本版积分规则

指导单位

江苏省公安厅

江苏省通信管理局

浙江省台州刑侦支队

DEFCON GROUP 86025

Hacking Group 021A

旗下站点

态势感知中心

应急响应中心

红盟安全

联系我们

官方QQ群:112851260

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

官方核心成员

关注微信公众号

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

GMT+8, 2026-11-16 07:51 , Processed in 0.034657 second(s), 18 queries , Gzip On, Redis On.

Powered by ihonker.com

Copyright © 2015-现在.

  • 返回顶部