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

適用的 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.requestHomeSpace()
// or
session.scene.requestFullSpace()

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

xrSession.scene.requestHomeSpace()

請參閱設計指南，進一步瞭解主畫面和全螢幕，以及如何在這兩者之間順暢切換。

宣告預設啟動模式

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

另請參閱