Full Color | AIUI | Rokid

Full Color 是面向乐奇全彩眼镜(英文名:Rokid Color)的 AIUI 视觉规范。它在透明显示中使用白色文字、彩色强调与清晰描边,让用户在有限视野中快速读取结果。

Full Color

Full Color 是面向乐奇全彩眼镜(英文名:Rokid Color)的 AIUI 视觉规范。它在透明显示中使用白色文字、彩色强调与清晰描边,让用户在有限视野中快速读取结果。

开始迁移现有智能体前,请先阅读全彩眼镜适配指南。单色设备继续使用 Monochrome,不要将两套尺寸、字号与填充规则混用。

核心设计约束

以下尺寸使用设计逻辑单位;文字单位为 dp。WXSS 采用主题一致的逻辑 px 值编写,不直接使用硬件物理像素。

项目要求
内容区域宽 448,最高 352;内容与外边距整体位于区域内
文字14~24 dp
图标不小于 12 × 12
背景主题背景始终为纯黑 #000000;卡片和控件优先透明
大面积填充不使用大面积底色,用留白与描边建立结构
可见内容 alpha建议不低于 40%
最外层卡片所有状态均无边框;保留圆角 12 与现有间距
内部卡片圆角 12,1px 白色内部描边,默认 alpha 30%
选中或聚焦的内部卡片白色描边 alpha 100%,保持 1px 的宽度
卡片内边距内容到边框左右各 10,上下各 24
FOV 边距卡片到 FOV 边缘保留 10
分割线宽 1,alpha 40%

本页的“透明度 30%”指颜色的 alpha 值 0.3,即内部卡片默认边框使用 rgba(255,255,255,0.3)。内部卡片边框、透明容器和黑色背景不受可见前景 40% 建议下限约束;文字与图标保留该建议下限,分割线仍为 alpha 40%。

黑色与透视显示

纯黑在眼镜端显示为透明,不能当作遮住真实世界的不透明底板。不要用黑字表达内容,也不要用明暗度过低的深灰、深蓝等颜色承载关键文字、图标与线条。

黑色页面背景与透明卡片是基线。关键内容优先使用白色或清晰的亮色,并在浅色、复杂真实背景下验证。桌面预览中的黑底对比效果不等于眼镜上的可读性。

颜色系统

以下为内置全彩主题的主要默认值。语义色用于辅助状态表达,错误、成功与选中状态仍应有文字、图标或形状提示。

Token用途默认值
--color-background页面背景#000000
--color-surface / --color-surface-highlight容器与高亮容器背景transparent
--color-text-primary正文、关键文字#ffffff
--color-text-secondary次级文字rgba(255,255,255,0.6)
--color-primary主强调色#66b3ff
--color-secondary / --border-color-success辅助强调、成功#80e6b0
--border-color-danger错误提示#ff8080
--border-color-warning警告提示#ffd966
--border-color-highlight分类强调#c4a6ff
--border-color-default默认控件边框rgba(255,255,255,0.6)
--border-color-muted弱化边框、分割线rgba(255,255,255,0.4)
--border-color-strong选中与焦点边框#ffffff

为单独的文字或边框设置颜色 alpha,不要对整个卡片设置 opacity: 0.4。父级透明度会同时削弱子内容,并可能让已经半透明的前景低于可读性基线。

排版与图标

层级建议字号主题对应值
重点标题24--font-size-max;header 默认使用
卡片标题20--card-title-font-size
正文与操作16text、p、输入与按钮的默认字号
辅助信息14--card-footer-font-size;字号下限 --font-size-min
图标默认 16,最小 12 × 12--icon-size-min

这些 Token 与默认样式不是对所有自定义内容的自动校正。页面自行设置的字号、图片内文字、Canvas 标注都需要检查。内容放不下时先减少信息量,再做分步展示,保持字号与图标下限。

卡片、间距与焦点

Token当前主题默认值(卡片边框需按下方覆盖)
--app-width448px
--card-margin10px
--card-padding10px,水平内容间距
--card-padding-y24px,垂直内容间距
--card-radius12px
--card-border-width2px
--card-border-color白色 alpha 60%
--card-focus-border-color白色 alpha 100%
--card-divider-width / --card-divider-color1px / 白色 alpha 40%

上表为当前主题默认值。需覆盖卡片边框以符合本规范:最外层布局卡片无边框,内部卡片使用 1px、alpha 30% 的白色边框,聚焦与选中时仍为 alpha 100%。例如,在全彩布局中为对应的 card 元素添加以下类:

@media (color) {
  .outer-card {
    border: 0;
  }
  .inner-card {
    margin: 0;
    border: 1px solid rgba(255,255,255,0.3);
  }
  .inner-card:focus,
  .inner-card:host-focus,
  .inner-card.is-selected {
    border-color: #ffffff;
  }
}

预留 10 的 FOV 边距后,无边框最外层卡片最多为 428 × 332;扣除左右 10、上下 24 的内边距,内容区域为 408 × 284。内部卡片的描边与内边距也需从这部分空间扣除。

最高 352 是内容设计约束,不是主题自动施加的高度裁剪。把卡片外边距、边框、内边距、标题和操作一起计入预算;超出的内容应拆分、分页或滚动,不能只用 overflow: hidden 隐藏。

为可交互的内部卡片提供清晰的 :focus 与 :host-focus 样式,最外层布局卡片保持无边框。业务选中态需要单独维护,不能只依靠 hover 或颜色变化。焦点行为见焦点系统。

组件与资源基线

  • 卡片、按钮与输入框:优先透明背景与白色文字;最外层卡片无边框,内部卡片使用上述描边,按钮与输入框保留现有边框要求,并提供清晰焦点反馈。
  • 图片与图标:优先轮廓清晰、主体明确的资源;装饰图使用透明背景,避免大块底色与暗色细节。
  • 图表:优先线条与空心轮廓,使用标签、单位和图例辅助颜色,避免大面积实心色块。
  • 地图:优先展示路线、位置与必要标注,避免大量面状填色占满视野。
  • 错误与空态:简洁说明当前状态和下一步操作,配合图标或描边,不只改变颜色。

交付检查

交付前确认内容区域、文字、图标、内外边距和焦点态符合本页数值;检查纯黑、暗色细节、透明度叠加与大面积填充。最后在目标眼镜上验证不同光照与真实背景下的阅读、确认、返回与滚动。

实现步骤见全彩眼镜适配指南,体验排查与优化见全彩优化指南。

设计源

完整的 design.md 格式设计源见 design/fullcolor/design.md,包含 YAML Token 定义、组件模式、状态、主题映射与验收要求。修改规范时,请同步更新设计源与本页的中英文版本。

全彩效果预览见 preview-color.html。下载后可在浏览器直接打开,无需构建。