空間形狀（visionOS）
空間形狀是專為 Apple Vision Pro 設計的 visionOS 專屬 AR 工具。它提供玻璃風格的控制介面，讓您進入 AR 空間並新增/管理 3D 物件。
iPhoneiPadMacApple Vision ProApple TVApple Watch
目錄
可用性
- 空間形狀僅適用於 visionOS。
- 在 iOS/iPadOS 上，請使用 AR 工具來獲得 AR 體驗。
進入 AR 空間
右側控制項包含 Enter AR Space/Exit AR Space 按鈕。您必須先進入 AR 空間才能新增物件。
新增物件
在螢幕頂部，標題按鈕會根據狀態改變：
- Enter AR Space First：當 AR 空間未啟用時顯示。
- Add Object...：進入 AR 空間後顯示。
當您點擊 Add Object... 時，會出現一個包含三個分頁的選擇器：
- Primitives —— 四個基本形狀的網格：Sphere、Cube、Cylinder 和 Cone。每個都有 獨特的圖示和顏色。
- Bundled —— 可搜尋的內建 USDZ 模型網格。使用搜尋列按名稱篩選。
- Import —— 檔案匯入區段，包含 Browse Files 按鈕，可開啟「檔案」App 從 iCloud 雲碟、本機儲存空間或任何已連接的供應商匯入 USDZ 檔案。
如果物件正在載入中，工具會顯示載入覆蓋層，顯示正在載入的物件名稱。
物件預設會放置在眼睛高度，大約在使用者前方 50 公分處。
物件列表
左側卡片顯示目前的物件列表：
- 當列表為空時，會顯示空狀態提示。
- 當列表有內容時，您可以選取物件以聚焦，或從列表中刪除物件。
已選取物件
已選取物件卡片顯示：
- 名稱
- 縮放比例
- 位置（X/Y/Z）
- 旋轉（Y）
物件操作
在沉浸式空間中，可以使用手勢直接操作物件。使用捏合並拖曳來移動、旋轉和縮放空間中的物件。鬆開手勢後，物件會保持在您放置的位置。
當您操作物件時，已選取物件卡片會即時更新，保持位置、旋轉和縮放值同步。
手部追蹤
空間形狀使用 ARKit 進行即時手部追蹤。對於每隻手（左手和右手），浮動資料面板會附著在您的手腕上（如同虛擬手錶），並顯示：
- 位置（從手腕關節測量的 X、Y、Z，單位為公尺）
- 旋轉（歐拉角，單位為度）
- 方向（前向向量）
- 速度（公尺/秒）
- 追蹤狀態（追蹤中顯示綠色指示燈，遺失時顯示紅色）
這些面板會即時跟隨手部移動，提供 ARKit 如何感知您手部位置的即時回饋。
線框模式
空間形狀包含線框模式切換。啟用時，所有物件材質會替換為線條渲染，僅顯示網格邊緣。停用線框模式會恢復原始材質。
注意事項與限制
- 可用物件的確切集合取決於建置版本以及內建或支援匯入的資源。
- 部分內建資源具有預先設定的旋轉和縮放值，會在放置時套用。
- 空間形狀僅適用於 visionOS。在 iOS/iPadOS 上，請改用 AR 工具。