Dostęp do sesji umożliwiającej tworzenie przestrzennego interfejsu i encji

Odpowiednie urządzenia XR
Te wskazówki pomogą Ci tworzyć treści na te urządzenia XR.
Więcej informacji o typach urządzeń XR →
Gogle XR
Przewodowe okulary XR
Więcej informacji o typach urządzeń XR →

Session zapewnia główny interfejs do funkcji przestrzennych w aplikacji. Każdy przestrzenny Activity musi utworzyć i przechowywać instancję Session. Po utworzeniu sesji aplikacja może używać interfejsów Session do tworzenia przestrzennych elementów treści, takich jak panele lub modele 3D, a także ustawiać środowisko przestrzenne, określać pozycję użytkownika i zakotwiczać treści w świecie rzeczywistym.

Dostęp do sesji z Jetpack Compose na XR

Gdy używasz Jetpack Compose na potrzeby XR, sesja jest tworzona automatycznie i możesz uzyskać do niej dostęp za pomocą LocalSession.current. Przyjrzyj się temu przykładowi:

@Composable
fun ComposableUsingSession() {
    val session = LocalSession.current
}
Session.kt

Dostęp do sesji z poziomu środowiska wykonawczego Jetpack XR

Jeśli tworzysz przestrzenne obiekty z biblioteki Jetpack SceneCore, musisz utworzyć sesję.

Aby utworzyć sesję, przekaż aktywność do metody create(), jak pokazano w tym przykładzie:

when (val result = Session.create(this)) {
    is SessionCreateSuccess -> {
        val xrSession = result.session
        // ...
    }
    else ->
        TODO(/* A different unhandled exception was thrown. */)
}
Session.kt

Gdy aktywność sesji zostanie zniszczona, wszystkie powiązane z nią elementy interfejsu przestrzennego i treści 3D zostaną zniszczone, a sesja przestanie być ważna.

Zobacz również