Przejście z obszaru domowego na pełny obszar

Użytkownik może korzystać z aplikacji w 2 trybach: Przestrzeń domowa lub Pełna przestrzeń. W przestrzeni domowej użytkownik może wykonywać wiele zadań jednocześnie, korzystając z Twojej aplikacji i innych aplikacji. W przestrzeni pełnej Twoja aplikacja jest w centrum uwagi użytkownika i ma pełny dostęp do funkcji Androida XR.

Aplikacja otwiera się domyślnie w przestrzeni domowej, chyba że określisz inaczej, jak opisano w sekcji Deklarowanie domyślnego trybu uruchamiania.

Przestrzenność jest obsługiwana tylko w przestrzeni pełnej. Aplikacja może przejść do trybu pełnej przestrzeni, aby wykorzystać możliwości przestrzenne i 3D. Gdy aplikacja jest aktywna, możesz przełączać się między tymi trybami, prosząc o odpowiednią przestrzeń.

Przechodzenie między przestrzenią strony głównej a pełną przestrzenią

Jeśli używasz biblioteki Jetpack Compose for XR, poproś o przestrzeń domową lub pełną przestrzeń za pomocą lokalnego komponentu LocalSpatialConfiguration.

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

Jeśli używasz biblioteki Jetpack SceneCore, możesz poprosić o odpowiednią przestrzeń w Session. Więcej informacji znajdziesz w artykule Uzyskiwanie dostępu do sesji z Jetpack SceneCore.

xrSession.scene.requestHomeSpaceMode()
ModeTransition.kt

Przykłady użycia tych żądań do przełączania się między trybami przez kliknięcie przycisku znajdziesz w samouczku Learn Android XR Fundamentals: Part 1 - Modes and Spatial Panels. Zalecamy też zapoznanie się z naszymi wskazówkami dotyczącymi projektowania, aby dowiedzieć się więcej o przechodzeniu z przestrzeni domowej do pełnej przestrzeni i jak najlepiej to zrobić.

Deklarowanie domyślnego trybu uruchamiania

Możesz też dodać te wiersze do pliku manifestu Androida, aby wybrać przestrzeń, w której 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_MANAGED" />

Zobacz również