공간화된 UI 및 항목을 만들기 위한 세션에 액세스

해당 XR 기기
이 안내는 이러한 유형의 XR 기기용 환경을 구축하는 데 도움이 됩니다.
XR 기기 유형 알아보기 →
XR 헤드셋
유선 XR 안경
XR 기기 유형 알아보기 →

Session는 앱의 공간화된 기능에 대한 기본 인터페이스를 제공합니다. 각 공간화된 Activity는 Session 인스턴스를 생성하고 보유해야 합니다. 앱이 세션을 만든 후에는 Session 인터페이스를 사용하여 패널이나 3D 모델과 같은 공간화된 콘텐츠 엔티티를 만들고 공간 환경을 설정하고 사용자 위치를 식별하고 콘텐츠를 실제 세계에 고정할 수 있습니다.

XR용 Jetpack Compose에서 세션 액세스

XR에 Jetpack Compose를 사용하는 경우 세션이 자동으로 생성되며 LocalSession.current를 사용하여 액세스할 수 있습니다. 아래 예를 참고하세요.

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

Jetpack XR 런타임에서 세션 액세스

Jetpack SceneCore 라이브러리에서 공간화된 엔티티를 만드는 경우 세션을 만들어야 합니다.

세션을 만들려면 다음 예와 같이 활동을 create() 메서드에 전달합니다.

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

세션의 활동이 소멸되면 해당 세션과 연결된 모든 공간 UI와 3D 콘텐츠가 소멸되고 세션이 더 이상 유효하지 않습니다.

참고 항목