这是 AUP Web-only widget,不是 cross-device primitive,也不是 Web Device layout component。
该名称登记在 AUP_WIDGETS(packages/aup/src/aup-types.ts)。结构校验可以接受它,Web runtime(或注明的原生目标)可以实现它。它不是 18 个跨设备 AUP_PRIMITIVES 之一,不会经 fillPrimitives 进入 DeviceCaps.primitives,也不是 Web Device 主题/站点 layout component(例如 content-card 或 page-breadcrumb)。
用途
仅原生(iOS/Android)的实时相机取景 widget。注册是为了结构校验接受该类型;有意不作为 web/cli 的 DeviceCaps primitive。
边界
- 不要把该类型写成可移植 primitive。
- 不要与 Web Device layout-component 参考页混装在
widgets/下。 - parser 接受名称 ≠ 可移植性或产品就绪声明。
作者入口
面向实现该能力的原生目标,使用 AUP tree type: "camera-preview"。按设计无 WebView 降级路径。
表面
原生移动(非交互 web-full,非 document)。Web 客户端无专用 case → unknown。
Fallback
无 web renderer;无共享 degradation chain。不要声称 web document 支持。
证据
| Source | Path |
|---|---|
| Registration | packages/aup/src/aup-types.ts (camera-previewinAUP_WIDGETS) |
| Contract test | packages/aup/test/aup-camera-preview-registration.test.ts |
| Caps note | DeviceCaps presets fill primitives only — camera-preview never appears in caps maps |
路径相对于本文档基线所用的 Arc 仓库 checkout。
Sample
不适合作为 docs sample。 副作用、写入路径、仅原生表面或信任敏感 endpoint 使公开 sample 不合适。本页仅作边界与证据索引。
相关
- Widgets hub — 仅导航
- Primitive 类型分类 — 18 vs 42 边界
- 自定义 primitive 与 Web widget
- 内部矩阵:
docs/aup/capability-matrix.md