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

適用的 XR 裝置
這份指南可協助您為這類 XR 裝置打造體驗。
瞭解 XR 裝置類型 →
XR 頭戴式裝置
有線 XR 眼鏡
瞭解 XR 裝置類型 →

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

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

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

使用 SpaceToggleButton 在主畫面和全螢幕之間切換

如要在首頁空間和完整空間之間轉換，請使用 Material Design for XR 程式庫中的 SpaceToggleButton 可組合函式。

這是可組合的按鈕，會根據目前的空間模式調整，並在全螢幕和主畫面模式之間切換。

在主畫面和全螢幕之間建立自訂轉場效果

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

val session = LocalSession.current ?: return
session.scene.requestHomeSpaceMode()
// or
session.scene.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" />

另請參閱