Przejście z obszaru domowego na pełny obszar

Obsługiwane urządzenia z XR
Te wskazówki pomogą Ci tworzyć aplikacje na te typy urządzeń z XR.
Więcej informacji o typach urządzeń z XR →
Gogle XR
Przewodowe okulary XR
Więcej informacji o typach urządzeń z XR →

Użytkownik może korzystać z Twojej aplikacji w 2 trybach: przestrzeni bazowej lub pełnej przestrzeni. W przestrzeni bazowej użytkownik może wykonywać wiele zadań jednocześnie, a Twoja aplikacja będzie działać obok innych aplikacji. W pełnej przestrzeni Twoja aplikacja jest najważniejsza i w pełni wykorzystuje możliwości Androida XR.

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

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

Używanie SpaceToggleButton do przełączania się między przestrzenią bazową a pełną przestrzenią

Aby przełączać się między przestrzenią bazową 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 pełną przestrzenią a przestrzenią bazową.

Tworzenie niestandardowego przejścia między przestrzenią bazową a pełną przestrzenią

Jeśli używasz biblioteki Jetpack Compose for XR, poproś o przestrzeń bazową lub pełną przestrzeń za pomocą LocalSession lokalnej kompozycji.

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 Dostęp do sesji z Jetpack SceneCore.

xrSession.scene.requestHomeSpace()

Przykłady użycia tych żądań do przełączania się między trybami za pomocą kliknięcia przycisku znajdziesz w ćwiczeniu Poznaj podstawy Androida XR: część 1 – tryby i panele przestrzenne. Zalecamy też zapoznanie 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 przełączać się między tymi trybami.

Deklarowanie domyślnego trybu uruchamiania

Możesz też dodać te wiersze do pliku manifestu Androida, aby wybrać, w której przestrzeni ma się otworzyć Twoja 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ż