Jetpack XR용 ARCore
| 최근 업데이트 | 안정화 버전 | 출시 후보 버전 | 베타 버전 | 알파 버전 |
|---|---|---|---|---|
| 2025년 7월 30일 | - | - | - | 1.0.0-alpha05 |
종속 항목 선언
Jetpack XR용 ARCore의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소를 참고하세요.
다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.
Groovy
dependencies { implementation "androidx.xr.arcore:arcore:1.0.0-alpha05" }
Kotlin
dependencies { implementation("androidx.xr.arcore:arcore:1.0.0-alpha05") }
종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.
의견
제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.
자세한 내용은 Issue Tracker 문서를 참고하세요.
버전 1.0
버전 1.0.0-alpha05
2025년 7월 30일
androidx.xr.arcore:arcore:1.0.0-alpha05, androidx.xr.arcore:arcore-guava:1.0.0-alpha05 및 androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha05이 출시되었습니다. 버전 1.0.0-alpha05에는 이 커밋이 포함되어 있습니다.
새로운 기능
- 개발자가 핸드 측 정보 (I270bd)를 가져올 수 있도록
getPrimaryHandSide추가 - 지리 공간 VPS 사용 가능 여부 확인 API 추가 (I58573)
checkVpsAvailability용 ARCore API 추가 (Idbded)- Java 개발자가 사용할 수 있도록
:xr:arcore:arcore-rxjava3에stateFlowable확장 함수가 추가되었습니다. (I083aa, b/427247794)
API 변경사항
*Mode값의 이름이 동작을 반영하도록 변경되었습니다. (I6d247, b/414648065)- 기본 ARCore 아티팩트 (xr:arcore:arcore)에는 Kotlin 스타일 비동기 API만 포함됩니다. Java 개발자는
xr:arcore:arcore-rxjava3라이브러리를 사용하여 호환되는 API에 액세스할 수 있습니다. (Ia525e, b/422794329) - 기본 ARCore 아티팩트 (
xr:scenecore:scenecore)에는 Kotlin 스타일 비동기 API만 포함됩니다. Java 개발자는xr:arcore:arcore-guava라이브러리를 사용하여 호환되는 API에 액세스할 수 있습니다. (Iffcb4, b/422773524) - Java 개발자가 사용할 수 있도록
AnchorGuava에Anchor.persistAsync()추가 (I4af1c, b/425984631) - Java 개발자가 사용할 수 있도록
EarthGuava에Earth.createAnchorOnSurfaceAsync(Session, Double, Double, Double, Quaternion, Surface)추가 (I66357, b/425992992) - Java 개발자는
GltfModel.kt에서GltfModel.createAsync의 확장 함수를 사용합니다.GltfModel의 비동기 함수가 삭제됩니다. (I0af60) - 이제 이 라이브러리는 유형 사용인 JSpecify nullness 주석을 사용합니다. Kotlin 개발자는 다음 컴파일러 인수를 사용하여 올바른 사용을 강제해야 합니다.
-Xjspecify-annotations=strict(Kotlin 컴파일러 버전 2.1.0부터 기본값임) (Ia8420, b/326456246) - Java 개발자가 사용할 수 있도록
:xr:arcore:arcore-rxjava3에subscribeAsFlowable확장 함수가 추가되었습니다. (Id3e49, b/427277298)
버전 1.0.0-alpha04
2025년 5월 7일
androidx.xr.arcore:arcore:1.0.0-alpha04이 출시되었습니다. 버전 1.0.0-alpha04에는 이러한 커밋이 포함되어 있습니다.
API 변경사항
- Kotlin 2.0으로 출시된 프로젝트를 사용하려면 KGP 2.0.0 이상이 필요합니다. (Idb6b5)
TrackingState및HandJointType이 ARCore에서 런타임으로 이동했습니다.Hand.State.isActive (boolean)가Hand.State.trackingState (androidx.xr.runtime.TrackingState)로 변경되었습니다.- UUID가 유효하지 않으면
Anchor.load는Anchor.AnchorLoadInvalidUuid을 반환합니다.
버전 1.0.0-alpha03
2025년 2월 26일
androidx.xr.arcore:arcore:1.0.0-alpha03은 마지막 알파 이후 중요한 변경사항 없이 출시되었습니다. 버전 1.0.0-alpha03에는 이 커밋이 포함되어 있습니다.
버전 1.0.0-alpha02
2025년 2월 12일
androidx.xr.arcore:arcore:1.0.0-alpha02이 출시되었습니다. 버전 1.0.0-alpha02에는 이 커밋이 포함되어 있습니다.
새로운 기능
- 손 추적 지원이 추가되었습니다.
Hand.left및Hand.right를 사용하여 추적 정보에 액세스합니다. - 이제 앵커를 생성하는 API (
Anchor.create,Anchor.load,Plane.createAnchor)가 모두AnchorCreateResult를 반환하고AnchorCreateResourcesExhausted를 올바르게 구현합니다.
버그 수정
Anchor.detach은 세션 업데이트 스레드와의 경합 상태로 인해 더 이상 치명적인 비정상 종료를 일으키지 않습니다.- 에뮬레이터에서 실행할 때
Anchor.create가 더 안정적임
버전 1.0.0-alpha01
2024년 12월 12일
androidx.xr.arcore:arcore-* 1.0.0-alpha01이 출시되었습니다.
초기 출시의 기능
기존 ARCore 라이브러리에서 영감을 받은 ARCore for Jetpack XR 라이브러리는 디지털 콘텐츠를 실제 세계와 혼합하는 기능을 제공합니다. 이 라이브러리에는 동작 추적, 영구 앵커, 적중 테스트, 시맨틱 라벨링 (예: 바닥, 벽, 테이블 상판)을 사용한 평면 식별이 포함됩니다. 개발자 가이드를 확인하여 Jetpack XR용 ARCore 사용에 대해 자세히 알아보세요.
Session: Jetpack XR용 ARCore는 내부적으로 Jetpack XR 런타임을 사용하여 기능을 지원합니다. 세션을 사용하여 대부분의 ARCore for Jetpack XR API와 상호작용하므로 세션 문서를 살펴보세요.Plane: 평면을 사용하여 주변 환경을 파악합니다. 각 평면에는 평면을 의미적으로 설명하는Label가 있습니다.subscribe를 사용하여 감지된 최신 비행기에 대한 알림을 받거나state를 사용하여 특정 비행기의 변경사항에 대한 알림을 받을 수 있습니다.Anchor: 가상 객체와 실제 위치 간의 링크입니다. 앵커는 공간의 특정 위치 (create사용) 또는Trackable(createAnchor사용)에 연결할 수 있습니다.앵커는 세션 간에 재사용할 수 있습니다.
persist을 사용하여 저장하고,getPersistedAnchorUuids을 사용하여 열거하고,load을 사용하여 검색할 수 있습니다. 더 이상 사용하지 않는 경우unpersist해야 합니다.앵커는 Jetpack XR용 ARCore와 Jetpack SceneCore 간에 상호 운용이 가능합니다. 앵커를 사용하여
AnchorEntity를 만들거나 기존 AnchorEntity가 있는 경우getAnchor를 사용하여 지원 앵커를 검색할 수 있습니다.hitTest을 사용하여 자연스러운 사용자 상호작용을 제공합니다. hitTest는Ray를 사용하여 교차하는 콘텐츠를 확인하고 해당 위치에서Anchor를 만듭니다.InputEvent에서 hitTest를 실행하는 것이 좋습니다.
알려진 문제
unpersist호출과getPersistedAnchorUuids에서 반환된 결과에서 UUID가 삭제되는 사이에 지연이 발생할 수 있습니다.create는 시스템에 새 앵커를 반환할 리소스가 충분한지 확인하지 않습니다. 과도한 양의 앵커를 만들면 비정상 종료가 발생할 수 있습니다.이전에 유지되었다가 유지되지 않은 앵커를 유지하는 것은 현재 지원되지 않습니다.
에뮬레이터에서의 사용은 지원되지만 실제 기기에서 실행할 때만큼 안정적이지 않을 수 있습니다. 특히
create호출이 네이티브 코드 오류로 실패하고 활동이 즉시 종료될 수 있습니다.특정 상황에서는 '앵커가 유지되지 않았습니다'라는 메시지와 함께
persist를 호출할 때RuntimeException가 잘못 발생할 수 있습니다. 이러한 상황에서도 함수는 계속 성공하고 앵커는 유지됩니다.persist호출을try블록으로 래핑하여 문제를 해결하는 것이 좋습니다.