Przejście z obszaru domowego na pełny obszar

Użytkownik może korzystać z aplikacji w 2 trybach: Home Space i Full Space. W HomeSpace użytkownik może wykonywać wiele zadań jednocześnie, korzystając z Twojej aplikacji obok innych aplikacji. W trybie Full Space Twoja aplikacja jest w centrum uwagi użytkownika, a on ma pełny dostęp do funkcji immersyjnych Androida XR.

Przestrzeń dźwiękową obsługujemy obecnie tylko w przypadku pełnej przestrzeni. Aplikacja może przejść do trybu Full Space, aby korzystać z możliwości dźwięku przestrzennego i 3D. Gdy aplikacja ma fokus, możesz przełączać się między tymi trybami, prosząc o odpowiednią sesję XR.

Aplikacja otwiera się domyślnie na ekranie Home Space, chyba że określisz inaczej, jak opisano w sekcji Zadeklaruj domyślny tryb uruchamiania.

Przejście między obszarem domowym a pełnym obszarem

Aby przełączać się między trybem Home Space i Full Space, musisz poprosić o tryb działania w Session. Jak widać w następującym przykładzie, możesz używać tych żądań, aby użytkownik mógł przełączać się między trybami, klikając przycisk.

@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)
        )
    }
}

Aby dowiedzieć się więcej o przejściu z pokoju głównego do pokoju pełnego i o tym, jak najlepiej je przeprowadzić, zapoznaj się z wskazówkami dotyczącymi projektowania.

Zadeklaruj domyślny tryb uruchamiania.

Aby wybrać, czy aplikacja ma się uruchamiać w obszarze Home Space czy Full Space, dodaj do pliku manifestu Androida te wiersze:

// 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" />

Zobacz również