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

使用者可以透過兩種模式體驗您的應用程式：首頁空間或完整空間。在首頁空間中，使用者可以同時執行您的應用程式和其他應用程式，進行多工處理。在完整空間中，應用程式會成為使用者體驗的焦點，並可完整存取 Android XR 的沉浸式功能。

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

空間化僅支援完整空間。應用程式可以轉換為完整空間模式，充分運用空間和 3D 功能。應用程式取得焦點後，您就能要求對應的空間，在這些模式之間轉換。

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

如果您使用 Jetpack Compose for XR 程式庫，請使用 LocalSpatialConfiguration 本機組合函式要求首頁空間或完整空間。

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

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

xrSession.scene.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" />

另請參閱