Passare dallo spazio Home a quello intero

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

L'app si apre nello spazio Home per impostazione predefinita, a meno che non specifichi diversamente come descritto nella sezione Dichiarare la modalità predefinita per l'avvio.

La spazializazione è supportata solo in Spazio intero. La tua app può eseguire la transizione a Spazio completo per sfruttare le funzionalità spaziali e 3D. Quando la tua app ha il focus, puoi passare da una modalità all'altra richiedendo lo spazio corrispondente.

Passare dallo spazio Home allo spazio intero

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

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

Se utilizzi la libreria Jetpack SceneCore, puoi richiedere lo spazio corrispondente da Session.

val xrSession = Session.create(this)
xrSession.spatialEnvironment.requestHomeSpaceMode()

Consulta il codelab Apprendimento di Android XR: Parte 1 - Modalità e riquadri spaziali 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 scoprire di più sullo spazio della casa e sullo spazio completo e su come passare al meglio da uno all'altro.

Dichiarare la modalità predefinita per l'avvio

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

Vedi anche