從首頁空間切換到完整空間

使用者可以透過兩種模式體驗您的應用程式，分別是首頁空間模式和完整空間模式。在首頁空間中，使用者可以同時執行多項工作，並與其他應用程式並排執行您的應用程式。在完整空間模式下，您的應用程式會成為使用者體驗的焦點，可完全存取 Android XR 的沉浸式功能。

除非您在「宣告啟動時的預設模式」一節中另有指定，否則應用程式預設會在首頁空間中開啟。

空間化功能僅支援全空間。應用程式可以轉換至完整空間模式，充分利用空間和 3D 功能。當應用程式獲得焦點時，您可以要求對應的空間，在這些模式之間切換。

在首頁空間和完整空間之間切換

如果您使用的是 Jetpack Compose for XR 程式庫，請使用 LocalSpatialConfiguration 本機組合項要求主畫面空間或完整空間。

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

如果您使用 Jetpack SceneCore 程式庫，可以透過 Session 要求相應的空間，請參閱「透過 Jetpack SceneCore 存取工作階段」。

xrSession.scene.spatialEnvironment.requestHomeSpaceMode()
ModeTransition.kt

如要瞭解如何透過點選按鈕，使用這些要求在不同模式之間轉換，請參閱「瞭解 Android XR 基本知識：第 1 部分 - 模式與空間面板」程式碼研究室。建議您參閱設計指南，進一步瞭解如何從首頁空間切換至完整空間，以及如何在兩者之間最佳化轉換。

宣告啟動作業的預設模式

或者，您也可以在 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" />

另請參閱