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

使用者可以透過兩種模式體驗您的應用程式：主畫面或全螢幕模式。在 Google Home 空間中，使用者可以同時執行多項工作，並與其他應用程式並排執行。在 Full Space 中，您的應用程式會成為使用者體驗的焦點，並可完全存取 Android XR 的沉浸式功能。

Spatialization 目前僅支援全空間。應用程式可以轉換為全螢幕模式，充分運用空間和 3D 功能。當應用程式獲得焦點時，您可以透過在 XR 工作階段中要求對應的模式，在這些模式之間轉換。

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

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

如要切換「居家空間」和「全空間」，您必須向 Session 要求運作模式。如以下範例所示，您可以使用這些要求，讓使用者透過點選按鈕在模式之間切換。

@Composable
private fun HomeSpaceFullSpaceToggleButton() {
    val xrSession = checkNotNull(LocalSession.current)

    val uiIsSpatialized = LocalSpatialCapabilities.current.isSpatialUiEnabled
    val toggleModes = if (uiIsSpatialized) {
        { xrSession.requestHomeSpaceMode() }
    } else {
        { xrSession.requestFullSpaceMode() }
    }

    IconButton(
        onClick = {
            toggleModes()
        }
    ) {
        Icon(
            painter = painterResource(id = drawable),
            contentDescription = stringResource(contentDescription)
        )
    }
}

請參閱設計指南，進一步瞭解如何從首頁空間切換至全螢幕模式，以及如何在兩者之間進行最佳轉換。

宣告啟動作業的預設模式

如要選擇應用程式是在 Home Space 或 Full Space 中啟動，請在 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" />

另請參閱