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.

Aplikacja otwiera się domyślnie w miejscu domowym, chyba że określisz inaczej, jak opisano w sekcji Zadeklaruj domyślny tryb uruchamiania.

Spójność przestrzenna jest obsługiwana tylko w przypadku pełnego pokoju. 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ą LocalSpatialConfigurationkompozycji lokalnej.

LocalSpatialConfiguration.current.requestHomeSpaceMode()
// or
LocalSpatialConfiguration.current.requestFullSpaceMode()
ModeTransition.kt

Jeśli używasz biblioteki Jetpack SceneCore, możesz poprosić o odpowiednią przestrzeń w Session. Zapoznaj się z artykułem Dostęp do sesji z poziomu Jetpack SceneCore.

xrSession.scene.spatialEnvironment.requestHomeSpaceMode()
ModeTransition.kt

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. Zalecamy też zapoznanie się z wskazówkami dotyczącymi projektowania, aby dowiedzieć się więcej o przechodzeniu z poziomu głównego na pełny 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ż