本技能用于为 3D 应用和游戏设计与构建用户界面。其核心思路是:好的 3D 应用 UI 需要做两个决定,一是 UI 放在哪里(空间内还是屏幕上),二是它看起来如何(设计质量)。本技能负责第一项的技术路由,并为第二项设定质量标准。
一、技术选型 按界面表面分别决定,一个应用常同时使用两种方式:
- 位于 3D 世界中的面板或控件:使用 drawcall-ai/uikitml。
- 面向 AR/VR 应用中的任何 UI(即使是平面面板,也会作为 3D 几何体渲染):使用 drawcall-ai/uikitml。
- 非 AR/VR 应用中的 2D HUD、菜单或覆盖层:使用 HTML/CSS。
空间与 XR UI 通过 drawcall-ai/uikitml 技能处理(安装命令:npx skills add drawcall-ai/uikitml),其 pmndrs/uikit 接口以严格的类 HTML 标记编写,可校验、预览,并转换为 Three.js / R3F / IWSDK。非 XR 应用中的平面 HUD/菜单外观就是画布上的普通 HTML/CSS,速度更快、功能完整、任意分辨率下都清晰,这里不需要 uikit。要让 3D 对象(包括空间 UI)响应点击与悬停,使用 @pmndrs/pointer-events 包。
二、加载屏幕 3D 应用在首帧之前需要完成实际工作,例如加载模型、纹理、环境贴图、音频;在此之前画布是空白的。如果不加覆盖,玩家的第一体验就是冻结的黑屏。应从最开始就显示加载屏幕(非 XR 应用中为画布上的普通 HTML/CSS),承载产品标识与加载进度,场景就绪后再淡出。它是 UX 的一部分,也是任何一次游玩首先看到的内容,不是事后补充;应按其余 UI 的同等标准设计,并让进度对应真实加载阶段推进,而不是伪造固定计时器。加载完成驱动显示,淡出用计时器触发,不要只靠 requestAnimationFrame;后台标签页或无头标签页(如截图/验证运行)可能暂停 rAF,导致加载器永远卡在屏幕上。
三、按元素实际尺寸处理 UI、画布、相机与后处理应跟随所渲染元素的实际盒子,而不是一次性的 window.innerWidth 快照。加载屏幕显示期间,用户可能进入全屏、旋转设备、调整浏览器大小,或应用宿主改变 iframe 尺寸。如果 resize 监听器只在异步加载完成后才注册,首个可玩帧可能仍保留旧的画布后备尺寸与相机宽高比,而 HUD 已填满新视口。
建议使用固定的全视口应用容器,并让画布样式填满它:
html, body { width: 100%; height: 100%; overflow: hidden; }
#app { position: fixed; inset: 0; width: 100%; height: 100%; }
canvas { width: 100%; height: 100%; display: block; }
在画布存在后立即注册尺寸监听,早于等待大型资源。对画布或其容器使用 ResizeObserver 通常比 window.resize 更可靠,因为它也能捕获不表现为普通浏览器 resize 的宿主/布局变化。每次尺寸更新时,一起调整所有屏幕尺寸的渲染目标:渲染器后备存储、相机宽高比/投影、后处理合成器,以及任何固定像素覆盖画布(如小地图)。保持 renderer.setSize(width, height, false),让 CSS 负责显示尺寸,并在设备缩放可能变化时更新像素比。fullscreenchange 与 visualViewport.resize 是有用的次要触发,应调用同一个 resize 函数,而不是复制逻辑。
具体检查方式:在加载屏幕仍处于活动状态时触发 resize 或全屏变化,然后在加载器消失前验证画布客户端尺寸、画布后备尺寸与相机宽高比都与当前视口一致。
四、专业级设计 目标是让界面看起来是为本产品有意设计的:游戏的 UI 应读起来像游戏 UI,工具的应像工具。失败模式是通用的“AI 应用”外观,它来自默认采用似是而非的通用模式,而不是做出审慎选择。应像工作室负责人一样,为产品赋予自己的身份。
把工艺花在关键处,其余保持极简。对用户操作的少数元素(主操作、实时读数、聚焦状态)投入丰富细节,让其他一切退后。统一装饰是噪音,有意的对比才是设计。渐进披露:只显示当前相关的内容,其余淡出或隐藏。
建立系统并坚持。审慎的调色板、字号阶梯与一致间距读起来有品质;一次性样式读起来像 AI。让它与所构建世界的基调匹配。
字体:避免默认字体栈(Inter、Roboto、Arial、系统字体)以及把等宽字体当作“技术感”的简写。选择适合产品的字体,用字重与字号建立层级。(uikit 提供 MSDF 字体,参见 uikitml 技能。)
色彩:确定一个主导色,用鲜明点缀,而不是胆怯的均匀分布。中性色略微偏向品牌色相;避免纯 #000/#fff。避开 AI 调色板——紫到蓝渐变、深色上的青色、霓虹辉光。
布局:用间距变化制造节奏(紧凑分组、宽松分隔);左对齐通常比全部居中更有设计感。优先使用留白、对齐、尺度与对比,再考虑添加装饰。不要把所有内容包进卡片,也不要重复相同卡片网格。
动效:少量有意的时刻胜过持续运动——一次精心编排的入场、一次有意义的悬停/揭示。保持快速克制,使用 ease-out 缓动;跳过弹跳/弹性。在 HTML 中动画 transform/opacity,而不是布局。
避免这些 AI 指纹:到处玻璃拟态、带通用投影的圆角卡片、霓虹辉光、用 emoji 当图标、标题/指标上的渐变文字、装饰性迷你趋势线、把模态框当懒惰默认。这些针对 UI 外观,不约束游戏世界本身;在游戏世界中,泛光与自发光辉光可以是合理外观的一部分,参见世界与后处理技能。
可读性与人体工学:强对比、舒适尺寸、清晰的焦点/悬停状态;在空间 UI 中保持目标够大、文字在远处可读。沉浸感永远不能压过可用性。
“slop 测试”:如果一眼看去会让人觉得“这是 AI 做的”,就重做。这些是护栏,不是牢笼——只要结果是有意的并符合产品,任何调色板、布局或动效都可以使用。