Passare dallo spazio Home a quello intero

Un utente può utilizzare la tua app in due modalità: Spazio della casa o Spazio completo. In Home Space, 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 l'app è in primo piano, puoi passare da una modalità all'altra richiedendo lo spazio corrispondente.

Transizione tra lo spazio Home e lo spazio intero

Se utilizzi la libreria Jetpack Compose per XR, richiedi lo spazio della casa o lo spazio completo utilizzando la composizione locale LocalSpatialConfiguration.

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

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

xrSession.scene.requestHomeSpaceMode()
ModeTransition.kt

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ù su Home Space e Full Space e su come passare al meglio da uno all'altro.

Dichiarare la modalità di avvio predefinita

In alternativa, puoi aggiungere le seguenti righe al file manifest di 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_MANAGED" />

Vedi anche