空间化组件

适用的 XR 设备

本指南可帮助您为以下类型的 XR 设备打造优质体验。

扩展现实头戴设备

有线扩展现实眼镜

Jetpack Compose for XR 包含各种空间化组件，可帮助您为应用构建空间界面和布局。

Subspace 可组合项

子空间可组合项是一种特殊类型的空间化组件，只能在子空间中渲染，并且必须先封装在 Subspace 中，然后才能放置在 2D 布局中。借助 SubspaceModifier，您可以向子空间可组合项添加深度、偏移和定位等属性。

其他空间化组件不需要在子空间内调用。它们由封装在空间容器中的传统 2D 元素组成。如果同时为 2D 和 3D 布局定义了这些元素，则可以在这两种布局中使用。如果未启用空间化，系统会忽略其空间化功能，并回退到其 2D 对应项。

空间化组件可以放置在应用界面层次结构中的任何位置。这些元素可在 2D 界面中重复使用，并且只有在启用空间功能时，其空间属性才可见。这样，您就可以为菜单、对话框和其他组件添加高度，而无需编写两次代码。以下示例展示了在启用或停用空间化功能时，不同的空间化组件如何改变其行为：

空间化组件	启用空间化时	在 2D 环境中
`SpatialDialog`	面板在 Z 轴深度上略微后退，以显示浮起的对话框	回退到 2D `Dialog`。
`SpatialPopup`	面板在 Z 轴深度上略微后退，以显示浮起的弹出式窗口	回退到 2D `Popup`。
`SpatialElevation`	可以设置 `SpatialElevationLevel` 来增加高度。	不带空间高度的显示。

本部分包含以下开发者指南：