Sessione

Session fornisce l'interfaccia principale per la funzionalità spazializzata per l'applicazione. Ogni attività spazializzata deve creare e contenere un'istanza di Session. Una volta creata, l'applicazione può utilizzare le interfacce Session per creare entità di contenuti spazializzati come pannelli o modelli 3D, nonché impostare un ambiente spaziale, identificare la posizione dell'utente e ancorare i contenuti al mondo reale.

Accedere alla sessione da Jetpack Compose per XR

Quando utilizzi Jetpack Compose per XR, la sessione viene creata per te e puoi accedervi utilizzando LocalSession.current. Vedi il seguente esempio:

import androidx.xr.compose.platform.LocalSession

class myActivity : Activity() {
   val xrSession = checkNotNull(LocalSession.current)
}

Accedere alla sessione da Jetpack SceneCore

Se crei entità spazializzate dalla libreria SceneCore, dovrai eseguire l'inizializzazione della sessione autonomamente.

La creazione di una sessione è supportata solo su un dispositivo Android XR. Al momento, se crei un Session e provi a utilizzarlo su un dispositivo XR non Android, visualizzerai un messaggio di errore.NullPointerException

Puoi creare una sola sessione per attività. Per creare una sessione, passa un'attività al metodo create, come mostrato nell'esempio seguente. Il tentativo di creare una sessione su un dispositivo non compatibile potrebbe generare errori di runtime.

import androidx.xr.scenecore.Session

class myActivity : Activity() {
  val xrSession = Session.create(this)
}

Quando l'attività di una sessione viene distrutta, tutti gli elementi dell'interfaccia utente spaziale e i contenuti 3D associati alla sessione vengono distrutti e la sessione non è più valida.

Vedi anche