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.
Aplikacja otwiera się domyślnie w miejscu domowym, chyba że określisz inaczej, jak opisano w sekcji Zadeklaruj domyślny tryb uruchamiania.
Spacjalność jest obsługiwana tylko w przypadku pełnej przestrzeni. Aplikacja może przejść do trybu Full Space, aby korzystać z możliwości związanych z przestrzenią i grafiką 3D. Gdy Twoja aplikacja jest aktywna, możesz przełączać się między tymi trybami, prosząc o odpowiednią przestrzeń.
Przejście między obszarem domowym a pełnym obszarem
Jeśli używasz Jetpack Compose do biblioteki XR, poproś o miejsce na ekranie głównym lub pełne miejsce za pomocą kompozycji lokalnej LocalSpatialConfiguration
.
LocalSpatialConfiguration.current.requestHomeSpaceMode()
// or
LocalSpatialConfiguration.current.requestFullSpaceMode()
Jeśli używasz biblioteki Jetpack SceneCore, możesz poprosić o odpowiednią przestrzeń w Session
.
val xrSession = Session.create(this)
xrSession.spatialEnvironment.requestHomeSpaceMode()
W tym celu możesz skorzystać z tego kodulabu Poznaj podstawy Androida XR: część 1 – tryby i panele przestrzenne, aby dowiedzieć się, jak używać tych żądań do przełączania się między trybami za pomocą kliknięcia przycisku. Zapoznaj się też z naszą przestrzenią projektową, aby dowiedzieć się więcej o przechodzeniu z poziomu Home do Full i odwrotnie.
Zadeklaruj domyślny tryb uruchamiania.
Aby wybrać, w której przestrzeni ma się otwierać aplikacja, możesz też dodać 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ż
- Sprawdzanie możliwości przestrzennych
- Tworzenie sesji
- Dodawanie środowisk do aplikacji
- Dodawanie modeli 3D do aplikacji