XR 런타임

네이티브 런타임으로 맞춤 AR 또는 3D 세션을 시작하세요.
최근 업데이트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
2025년 5월 7일 - - - 1.0.0-alpha04

종속 항목 선언

XR 런타임의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

GroovyKotlin
dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha04"

    // Use in environments that do not support OpenXR
    testImplementation "androidx.xr.runtime:runtime-testing:1.0.0-alpha04"
}
dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha04")

    // Use in environments that do not support OpenXR
    testImplementation("androidx.xr.runtime:runtime-testing:1.0.0-alpha04")
}

종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

버전 1.0

버전 1.0.0-alpha04

2025년 5월 7일

androidx.xr.runtime:runtime:1.0.0-alpha04, androidx.xr.runtime:runtime-openxr:1.0.0-alpha04androidx.xr.runtime:runtime-testing:1.0.0-alpha04이 출시되었습니다. 버전 1.0.0-alpha04에는 이 커밋이 포함되어 있습니다.

새로운 기능

  • 이제 세션은 기존 Android 수명 주기 패러다임과의 상호 운용성을 높이기 위해 androidx.lifecycle.LifecycleOwner를 구현합니다.
  • Android XR의 매니페스트 문자열은 여기에 지정되고 문서화되어 있습니다.
  • 장면 콘텐츠가 사용자의 시야 안팎으로 이동할 때 이를 모니터링하는 공간 가시성 콜백 확장 메서드가 추가되었습니다.
  • JxrPlatformAdapter 및 모든 관련 클래스의 스텁 버전을 추가했습니다.
  • Session은 SceneCore의 Session 대신 SceneCore 및 런타임 모두에서 사용됩니다.
  • 가상 콘텐츠에 대한 hitTest를 사용 설정하는 ActivityPose.hitTest가 추가되었습니다.
  • 이제 컴파일 시 여러 런타임 구현을 지정할 수 있습니다. 현재 기기의 기능 세트를 기반으로 실행 시 하나만 로드됩니다.
  • 클라이언트가 포인터에 렌더링된 아이콘을 지정하거나 아이콘을 사용 중지할 수 있는 새 구성요소 유형 SpatialPointerComponent를 추가했습니다. 이 구성요소는 현재 PanelEntity 인스턴스에만 연결할 수 있습니다.

API 변경사항

  • Config 구현을 공개로 설정합니다. (I95860)
  • HandJointTypeTrackingState를 추가합니다. (I55880)
  • Kotlin 2.0으로 출시된 프로젝트를 사용하려면 KGP 2.0.0 이상이 필요합니다 (Idb6b5).
  • Hand.isActive (boolean)Hand.trackingState로 변경되었습니다. 이에 따라 OpenXR 구현이 수정되었습니다.
  • Session.configureandroid.permission.SCENE_UNDERSTANDING 권한 요구사항이 android.permission.SCENE_UNDERSTANDING_COARSE로 변경되었습니다.
  • LifecycleManager.configure가 구현되었으며 이제 구성 가능한 각 런타임 기능의 속성이 포함된 Config 객체를 전달합니다.
  • 이제 사용 가능한 런타임 기능을 구성하기 위해 ConfigSession.configure를 호출할 수 있습니다.
  • 이제 Session.createCoroutineDispatcher 대신 CoroutineContext 전달을 지원합니다.
  • Session.create는 Jetpack XR 또는 SceneCoreARCore 로드를 지원합니다. 하나 이상 제공해야 합니다 (테스트 버전 사용 가능).
  • 잘못된 UUID가 Anchor.loadAnchor.unpersist에 전달되면 FakePerceptionManager에서 AnchorInvalidUuidException이 발생합니다.
  • CoreState가 더 이상 데이터 클래스가 아닙니다.

버그 수정

  • 런타임 Proguard 구성을 수정했습니다.

버전 1.0.0-alpha03

2025년 2월 26일

androidx.xr.runtime:runtime:1.0.0-alpha03, androidx.xr.runtime:runtime-openxr:1.0.0-alpha03, androidx.xr.runtime:runtime-testing:1.0.0-alpha03은 지난 알파 버전 이후 변경사항 없이 출시되었습니다. 버전 1.0.0-alpha03에는 이 커밋이 포함되어 있습니다.

버전 1.0.0-alpha02

2025년 2월 12일

androidx.xr.runtime:runtime:1.0.0-alpha02, androidx.xr.runtime:runtime-openxr:1.0.0-alpha02androidx.xr.runtime:runtime-testing:1.0.0-alpha02이 출시되었습니다. 버전 1.0.0-alpha02에는 이 커밋이 포함되어 있습니다.

중대한 변경사항 및 동작 변경사항

  • 이제 앵커를 반환하는 OpenXR 런타임 함수가 OpenXR 리소스 한도에 도달했음을 알리는 오류 코드가 발생하면 AnchorResourcesExhaustedException을 발생시킵니다.
  • 이제 Session.createSession.resumeandroid.permission.HAND_TRACKING 권한이 필요합니다.

새로운 기능

  • 손 추적 지원을 추가했습니다.

버그 수정

  • 에뮬레이터에서 실행할 때 앵커를 만드는 것이 더 안정적임

버전 1.0.0-alpha01

2024년 12월 12일

androidx.xr.runtime:runtime-* 1.0.0-alpha01이 출시되었습니다.

초기 출시의 기능

Jetpack XR 런타임의 첫 번째 버전입니다. 이 라이브러리에는 Jetpack XR 라이브러리 모음의 기본 기능이 포함되어 있습니다. 여기에는 기능 검색, 수명 주기 관리, 구성 등이 포함됩니다. 런타임 라이브러리는 실행 플랫폼에 따라 다양한 변형 (예: runtime-openxr 또는 runtime-testing)을 제공합니다. 또한 이 라이브러리는 전체 Jetpack XR API 노출 영역에서 사용되는 Vector3Matrix4와 같은 기본 수학 추상화를 제공합니다.

  • Session: 처리가 실행되는 시점과 실행되지 않는 시점 결정 및 전반적인 구성을 비롯하여 XR 시스템을 세부적으로 제어할 수 있습니다. 또한 다른 모든 API에서 기본 시스템 기능을 사용 설정하는 데 사용할 핸들입니다.

  • Pose: 위치와 방향이 연결된 임의의 좌표계의 위치입니다. 이 클래스를 사용하여 Jetpack XR 및 Jetpack SceneCore용 ARCore와 객체의 위치를 통신합니다.

알려진 문제

  • configure는 현재 무작위 작업입니다. 향후 출시에서는 Session의 동작을 제어하는 데 사용할 수 있는 새로운 설정이 추가됩니다.