Sesja

Session to główny interfejs umożliwiający korzystanie z funkcji przestrzennych w aplikacji. Każda zlokalizowana aktywność musi utworzyć i zawierać instancję Session. Po utworzeniu aplikacja może używać interfejsów Session do tworzenia elementów treści przestrzennych, takich jak panele czy modele 3D, a także ustawienia środowiska przestrzennego, identyfikowania pozycji użytkownika i ankreowania treści w świecie rzeczywistym.

Otwieranie sesji w Jetpack Compose w przypadku XR

Gdy używasz Jetpack Compose na potrzeby XR, sesja jest tworzona dla Ciebie i możesz uzyskać do niej dostęp za pomocą LocalSession.current. Zobacz ten przykład:

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

Dostęp do sesji z Jetpack SceneCore

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

Tworzenie sesji jest obsługiwane tylko na urządzeniu z Androidem XR. Próba utworzenia sesji na urządzeniu niezgodnym z wymaganiami zakończy się niepowodzeniem. Aby utworzyć sesję, prześlij działanie do metody create(), jak pokazano w tym przykładzie.

when (val result = Session.create(this)) {
    is SessionCreateSuccess -> {
        val xrSession = result.session
        // ...
    }
    is SessionCreatePermissionsNotGranted ->
        TODO(/* The required permissions in result.permissions have not been granted. */)
}
Session.kt

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

Zobacz również