XR 런타임
최근 업데이트 | 안정화 버전 | 출시 후보 버전 | 베타 버전 | 알파 버전 |
---|---|---|---|---|
2025년 5월 7일 | - | - | - | 1.0.0-alpha04 |
종속 항목 선언
XR 런타임의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소를 읽어보세요.
다음과 같이 앱 또는 모듈의 build.gradle
파일에 필요한 아티팩트의 종속 항목을 추가합니다.
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-alpha04
및 androidx.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)
HandJointType
및TrackingState
를 추가합니다. (I55880)- Kotlin 2.0으로 출시된 프로젝트를 사용하려면 KGP 2.0.0 이상이 필요합니다 (Idb6b5).
Hand.isActive (boolean)
가Hand.trackingState
로 변경되었습니다. 이에 따라OpenXR
구현이 수정되었습니다.Session.configure
의android.permission.SCENE_UNDERSTANDING
권한 요구사항이android.permission.SCENE_UNDERSTANDING_COARSE
로 변경되었습니다.LifecycleManager.configure
가 구현되었으며 이제 구성 가능한 각 런타임 기능의 속성이 포함된Config
객체를 전달합니다.- 이제 사용 가능한 런타임 기능을 구성하기 위해
Config
로Session.configure
를 호출할 수 있습니다. - 이제
Session.create
는CoroutineDispatcher
대신CoroutineContext
전달을 지원합니다. Session.create
는 Jetpack XR 또는SceneCore
의ARCore
로드를 지원합니다. 하나 이상 제공해야 합니다 (테스트 버전 사용 가능).- 잘못된 UUID가
Anchor.load
및Anchor.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-alpha02
및 androidx.xr.runtime:runtime-testing:1.0.0-alpha02
이 출시되었습니다. 버전 1.0.0-alpha02에는 이 커밋이 포함되어 있습니다.
중대한 변경사항 및 동작 변경사항
- 이제 앵커를 반환하는
OpenXR
런타임 함수가OpenXR
리소스 한도에 도달했음을 알리는 오류 코드가 발생하면AnchorResourcesExhaustedException
을 발생시킵니다. - 이제
Session.create
및Session.resume
에android.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 노출 영역에서 사용되는 Vector3
및 Matrix4
와 같은 기본 수학 추상화를 제공합니다.
Session
: 처리가 실행되는 시점과 실행되지 않는 시점 결정 및 전반적인 구성을 비롯하여 XR 시스템을 세부적으로 제어할 수 있습니다. 또한 다른 모든 API에서 기본 시스템 기능을 사용 설정하는 데 사용할 핸들입니다.Pose
: 위치와 방향이 연결된 임의의 좌표계의 위치입니다. 이 클래스를 사용하여 Jetpack XR 및 Jetpack SceneCore용 ARCore와 객체의 위치를 통신합니다.
알려진 문제