空間化元件

適用的 XR 裝置

本指南可協助您為這類 XR 裝置打造體驗。

XR 頭戴式裝置

有線 XR 眼鏡

Jetpack Compose for XR 包含多種空間化元件，可協助您建構應用程式的空間 UI 和版面配置。

Subspace 可組合項

子空間可組合項是一種特殊的空間化元件，只能在子空間中算繪，且必須先用 Subspace 括住，才能放入 2D 版面配置。SubspaceModifier 可讓您為子空間可組合項新增深度、偏移和定位等屬性。

其他空間化元件則不需要在子空間內呼叫。這類應用程式由傳統 2D 元素組成，並包裝在空間容器中。如果同時定義 2D 和 3D 版面配置，則可在這兩種版面配置中使用這些元素。如果未啟用空間化，系統會忽略空間化功能，並改用 2D 版本。

立體化元件可放在應用程式 UI 階層中的任何位置。這些元素可在 2D UI 中重複使用，且只有在啟用空間功能時，才能看到其空間屬性。這樣一來，您就能為選單、對話方塊和其他元件新增高度，不必重複編寫程式碼。以下舉例說明啟用或停用空間化功能時，不同空間化元件的行為變化：

空間化元件	啟用立體聲效果時	在 2D 環境中
`SpatialDialog`	面板在 Z 軸深度上稍微向後推，顯示浮動對話方塊	改用 2D `Dialog`。
`SpatialPopup`	面板在 Z 軸深度上稍微向後推，顯示浮動彈出式視窗	備用方案為 2D `Popup`。
`SpatialElevation`	可設定 `SpatialElevationLevel` 來增加高度。	顯示沒有空間高度。

本節包含下列開發人員指南：