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

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

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

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

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

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

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

如果您使用的是 Jetpack SceneCore 程式庫，可以從 Session 要求對應的空間。

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

如要瞭解如何透過點選按鈕，使用這些要求在不同模式之間轉換，請參閱「瞭解 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" />

另請參閱