空间形状 (visionOS)
空间形状是一款专为 Apple Vision Pro 设计的 visionOS 专属 AR 工具。它提供玻璃风格的控制界面，用于进入 AR 空间并添加/管理 3D 对象。
目录
可用性
- 空间形状仅在 visionOS 上可用。
- 在 iOS/iPadOS 上，AR 工具提供 AR 体验。
进入 AR 空间
右侧控制区包含一个进入 AR 空间 / 退出 AR 空间按钮。您必须先进入 AR 空间才能添加对象。
添加对象
屏幕顶部的标题按钮会根据状态变化：
- 请先进入 AR 空间：在 AR 空间未激活时显示。
- 添加对象...：进入 AR 空间后显示。
当您点击**添加对象...**时，会出现一个包含三个标签页的选择器：
- 基本形状 -- 包含四种基本形状的网格：球体、立方体、圆柱体和圆锥体。每种形状都有独特的图标和颜色。
- 内置模型 -- 可搜索的内置 USDZ 模型网格。使用搜索栏按名称筛选。
- 导入 -- 文件导入区域，包含一个浏览文件按钮，可打开"文件"应用从 iCloud 云盘、本地存储或任何已连接的提供商导入 USDZ 文件。
如果对象正在加载，工具会显示加载覆盖层，显示正在加载的对象名称。
对象默认放置在用户眼前约 50 厘米处的视线高度位置。
对象列表
左侧卡片显示当前对象列表：
- 为空时，显示空状态提示。
- 有内容时，您可以选择一个对象使其获得焦点，或从列表中删除对象。
已选对象
已选对象卡片显示：
- 名称
- 缩放
- 位置 (X/Y/Z)
- 旋转 (Y)
对象操控
在沉浸式空间中，可以使用手势直接操控对象。使用捏合并拖动来移动、旋转和缩放对象。松开手后，对象会保持在您放置的位置。
已选对象卡片会在您操控对象时实时更新，保持位置、旋转和缩放值同步。
手部追踪
空间形状包含使用 ARKit 的实时手部追踪功能。对于每只手（左手和右手），浮动数据面板会附着在您的手腕上（类似虚拟手表）并显示：
- 位置（来自手腕关节的 X、Y、Z 坐标，单位为米）
- 旋转（欧拉角，单位为度）
- 方向（前向向量）
- 速度（米/秒）
- 追踪状态（追踪中显示绿色指示器，丢失时显示红色）
这些面板会实时跟随手部移动，提供 ARKit 感知您手部位置的实时反馈。
线框模式
空间形状包含线框模式开关。启用后，所有对象材质会替换为线条渲染，仅显示网格边缘。禁用线框模式会恢复原始材质。
注意事项与限制
- 可用对象的确切数量取决于版本以及捆绑或支持导入的资源。
- 某些内置资源具有预配置的旋转和缩放值，会在放置时应用。
- 空间形状仅在 visionOS 上可用。在 iOS/iPadOS 上，请使用 AR 工具。