从居家空间切换到完整空间

用户可以通过 Home Space 或 Full Space 两种模式体验您的应用。在 Home Space 中，用户可以同时处理多个任务，您的应用可与其他应用并排运行。在 Full Space 中，您的应用是用户体验的焦点，可完全访问 Android XR 的沉浸式功能。

除非您在声明启动时的默认模式部分中另有说明，否则您的应用默认会在 Home Space 中打开。

空间化仅在完整空间中受支持。您的应用可以转换为 Full Space，以便利用空间和 3D 功能。当您的应用获得焦点时，您可以通过请求相应的空间，在这些模式之间进行转换。

居家空间与完整空间之间的转换

如果您使用的是适用于 XR 的 Jetpack Compose 库，请使用 LocalSpatialConfiguration 组合本地请求主屏幕或全屏。

LocalSpatialConfiguration.current.requestHomeSpaceMode()
// or
LocalSpatialConfiguration.current.requestFullSpaceMode()

如果您使用的是 Jetpack SceneCore 库，则可以从 Session 请求相应的空间。

val xrSession = Session.create(this)
xrSession.spatialEnvironment.requestHomeSpaceMode()

如需查看有关如何使用这些请求通过点击按钮在模式之间转换的示例，请参阅 学习 Android XR 基础知识：第 1 部分 - 模式和空间面板 Codelab。我们还建议您查看我们的设计指南，详细了解如何从 Home Space 切换到 Full Space，以及如何在两者之间进行最佳转换。

声明启动默认模式

或者，您也可以将以下代码行添加到 Android 清单文件中，以选择应用应在哪个空间中打开：

<!-- Launch in Full Space. -->
<property
   android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
   android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED" />

<!-- Or, launch in Home Space. -->
<property
   android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
   android:value="XR_ACTIVITY_START_MODE_HOME_SPACE_MANAGED" />

另请参阅