Użytkownik może korzystać z aplikacji w 2 trybach: przestrzeni bazowej lub pełnej przestrzeni. W przestrzeni domowej użytkownik może wykonywać wiele zadań jednocześnie, uruchamiając Twoją aplikację obok innych aplikacji. W trybie pełnej przestrzeni aplikacja zajmuje centralne miejsce i skupia uwagę użytkownika, zapewniając mu pełny dostęp do funkcji imersyjnych Androida XR.
Aplikacja domyślnie otwiera się w Przestrzeni domowej, chyba że określisz inaczej, jak opisano w sekcji Deklarowanie domyślnego trybu uruchamiania.
Przestrzenny dźwięk jest obsługiwany tylko w trybie pełnej przestrzeni. Aplikacja może przejść do trybu pełnej przestrzeni, aby korzystać z funkcji przestrzennych i 3D. Gdy aplikacja jest aktywna, możesz przełączać się między tymi trybami, żądając odpowiedniej przestrzeni.
Użyj SpaceToggleButton, aby przełączać się między przestrzenią bazową a pełną przestrzenią
Aby przełączać się między przestrzenią domową a pełną przestrzenią, użyj funkcji kompozycyjnej SpaceToggleButton z biblioteki Material Design for XR.
Jest to przycisk kompozycyjny, który dostosowuje się do bieżącego trybu przestrzennego i przełącza się między trybem pełnej przestrzeni a trybem przestrzeni bazowej.
Tworzenie niestandardowego przejścia między przestrzenią bazową a pełną przestrzenią
Jeśli używasz biblioteki Jetpack Compose for XR, poproś o przestrzeń domową lub pełną przestrzeń za pomocą kompozycji lokalnej LocalSession.
val session = LocalSession.current ?: return session.scene.requestHomeSpace() // or session.scene.requestFullSpace()
Jeśli używasz biblioteki Jetpack SceneCore, możesz poprosić o odpowiednią przestrzeń z Session. Zobacz Uzyskiwanie dostępu do sesji z Jetpack SceneCore.
xrSession.scene.requestHomeSpace()
Zapoznaj się z naszymi wskazówkami dotyczącymi projektowania, aby dowiedzieć się więcej o przechodzeniu z przestrzeni bazowej do pełnej przestrzeni i o tym, jak najlepiej przechodzić między tymi trybami.
Deklarowanie domyślnego trybu uruchamiania
Możesz też dodać do pliku manifestu Androida te wiersze, aby wybrać, w której przestrzeni ma się otwierać aplikacja:
<!-- 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" />
Zobacz też
- Sprawdzanie możliwości przestrzennych
- Tworzenie sesji
- Dodawanie środowisk do aplikacji
- Dodawanie modeli 3D do aplikacji