30 lines
1.3 KiB
Markdown
30 lines
1.3 KiB
Markdown
---
|
||
title: "Spatial Widgets"
|
||
type: concept
|
||
tags: []
|
||
sources: [visionos-spatial-engineer]
|
||
last_updated: 2026-04-25
|
||
---
|
||
|
||
## Definition
|
||
visionOS 26 引入的小组件系统，可吸附于 3D 空间中的墙面、桌面等表面，并持久化放置在物理位置，无需应用处于前台运行即可展示。
|
||
|
||
## Core Characteristics
|
||
- **Spatial Placement（空间放置）**：通过 SwiftUI API 定义 widget 在 3D 空间中的精确位置
|
||
- **Surface Snapping（表面吸附）**：自动识别并吸附到墙面、桌面等物理表面
|
||
- **Persistent Presence（持久化存在）**：Widget 保留在设定位置，用户返回时仍然可见
|
||
- **Cross-App Usage（跨应用使用）**：作为系统级功能，所有应用可共享 widget 展示
|
||
|
||
## Implementation Technologies
|
||
- **WidgetKit for visionOS**：Apple Widget 框架的 visionOS 扩展
|
||
- **SwiftUI Volumetric Widgets**：支持 volumetric 展示模式的 widget 类型
|
||
- **3D Positioning API**：定义 widget 在空间中的精确位置和朝向
|
||
|
||
## Related Concepts
|
||
- [[Liquid Glass Design System]]：Widget 的视觉呈现采用 Liquid Glass 风格
|
||
- [[Multi-Window Architecture]]：Widget 与主应用窗口的协同模式
|
||
- [[Spatial Layouts]]：Widget 在 3D 空间中的布局管理
|
||
|
||
## Sources
|
||
- [[visionos-spatial-engineer]] — visionOS Spatial Engineer Agent 角色定义
|