Un utente può utilizzare la tua app in due modalità: Spazio Home o Schermo intero. Nello spazio Home, un utente può eseguire il multitasking con la tua app in esecuzione affiancata ad altre app. In Full Space, la tua app è al centro dell'esperienza dell'utente e ha accesso completo alle funzionalità immersive di Android XR.
L'app si apre in Home Space per impostazione predefinita, a meno che tu non specifichi diversamente come descritto nella sezione Dichiarare la modalità di avvio predefinita.
La spatializzazione è supportata solo in Full Space. La tua app può passare a Full Space 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 dallo spazio personale allo spazio intero
Per passare da Spazio Home a Schermo intero, utilizza il composable
SpaceToggleButton della libreria Material Design per XR.
Si tratta di un pulsante componibile che si adatta alla modalità spaziale corrente e alterna Spazio intero e Spazio Home.
Creare una transizione personalizzata tra lo spazio della casa e lo spazio completo
Se utilizzi la libreria Jetpack Compose per XR, richiedi Spazio Home o Schermo intero utilizzando il locale di composizione LocalSpatialConfiguration.
LocalSpatialConfiguration.current.requestHomeSpaceMode() // or LocalSpatialConfiguration.current.requestFullSpaceMode()
Se utilizzi la libreria Jetpack SceneCore, puoi richiedere lo
spazio corrispondente da Session. Consulta Accedere alla sessione da Jetpack
SceneCore.
xrSession.scene.requestHomeSpaceMode()
Consulta il codelab Learn Android XR Fundamentals: Part 1 - Modes and Spatial Panels per esempi di come utilizzare queste richieste per passare da una modalità all'altra facendo clic su un pulsante. Ti consigliamo inoltre di consultare le nostre linee guida per la progettazione per saperne di più sullo spazio della casa e sullo spazio completo e su come passare al meglio da uno all'altro.
Dichiarare la modalità predefinita di avvio
In alternativa, puoi aggiungere le seguenti righe al file manifest Android per scegliere in quale spazio deve aprirsi la tua 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
- Verificare la presenza di funzionalità spaziali
- Create a session (Crea una sessione)
- Aggiungere ambienti all'app
- Aggiungere modelli 3D all'app