Passare dallo spazio Home a quello intero

Dispositivi XR applicabili
Queste indicazioni ti aiutano a creare esperienze per questi tipi di dispositivi XR.
Scopri di più sui tipi di dispositivi XR →
Visori XR
Occhiali XR con cavo
Scopri di più sui tipi di dispositivi XR →

Un utente può utilizzare la tua app in due modalità: Spazio Home o spazio intero. In Spazio Home, un utente può eseguire il multitasking con la tua app in esecuzione accanto ad altre app. In Spazio intero, la tua app è al centro dell'esperienza dell'utente con accesso completo alle funzionalità immersive di Android XR.

Per impostazione predefinita, l'app si apre in Spazio Home, a meno che tu non specifichi diversamente come descritto nella sezione Dichiara la modalità predefinita per l'avvio.

La spazializzazione è supportata solo in Spazio intero. La tua app può passare a Schermo intero per sfruttare le funzionalità spaziali e 3D. Quando la tua app è in primo piano, puoi passare da una modalità all'altra richiedendo lo spazio corrispondente.

Utilizza SpaceToggleButton per passare da Spazio Home a Spazio intero

Per passare da Spazio Home a Schermo intero, utilizza il SpaceToggleButton componibile della libreria Material Design per XR.

Si tratta di un pulsante componibile che si adatta alla modalità spaziale corrente e alterna Schermo intero e Spazio Home.

Crea una transizione personalizzata tra Spazio Home e Spazio intero

Se utilizzi la libreria Jetpack Compose per XR, richiedi Spazio Home o Schermo intero utilizzando la LocalSession composizione locale.

val session = LocalSession.current ?: return
session.scene.requestHomeSpace()
// or
session.scene.requestFullSpace()

Se utilizzi la libreria Jetpack SceneCore, puoi richiedere lo spazio corrispondente da Session; consulta Accedere alla sessione da Jetpack SceneCore.

xrSession.scene.requestHomeSpace()

Per esempi di come utilizzare queste richieste per passare da una modalità all'altra facendo clic su un pulsante, consulta il codelab Scopri le nozioni di base di Android XR: Parte 1 - Modalità e pannelli spaziali. Ti consigliamo inoltre di consultare le nostre indicazioni di progettazione per scoprire di più su Spazio Home e Schermo intero e su come passare al meglio da uno all'altro.

Dichiara la modalità predefinita per l'avvio

In alternativa, puoi aggiungere le seguenti righe al file manifest di Android per scegliere lo spazio in cui deve aprirsi l'app:

<!-- 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" />

Vedi anche