Jetpack XR용 ARCore

인식 기능을 통해 디지털 콘텐츠를 현실 세계로 가져옵니다.
최근 업데이트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
2026년 10월 21일 1.0.0 - - 1.1.0-alpha01

종속 항목 선언

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

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

Groovy

dependencies {
    implementation "androidx.xr.arcore:arcore:1.1.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.arcore:arcore:1.1.0-alpha01")
}

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

의견

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

새로운 문제 제출하기

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

버전 1.1

버전 1.1.0-alpha01

2026년 10월 21일

androidx.xr.arcore:arcore-*:1.1.0-alpha01이 출시되었습니다. 버전 1.1.0-alpha01에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • 3D 물리적 형태 및 객체를 추적하는 SpatialAnnotation API를 도입했습니다. 카메라 이미지 버퍼를 통해 공간 추적을 구성하기 위해 SpatialAnnotationTrackingOptions 및 해당 빌더 패턴을 추가했습니다. (I918ce)
  • Jetpack XR ARCore에 SpatialAnnotation 및 SpatialAnnotationTrackingMode를 도입하여 개발자가 실제 물리적 공간 환경을 타겟팅하는 임의의 경계가 지정된 3D 사변형 도형 (Quad)을 구성하고 추적할 수 있도록 했습니다. (I880e4)
  • 자동 테스트에서 공간 주석의 프로그래매틱 시뮬레이션을 허용하는 TestSpatialAnnotation를 추가했습니다. (If2335)
  • Geospatial 상태에 관한 더 많은 정보를 제공하기 위해 geospatialPose, horizontalAccuracy, verticalAccuracy, orientationYawAccuracy를 새로운 API로 추가했습니다. (If28f8)

버그 수정

  • androidx.lifecycle:lifecycle-runtime 종속 항목이 2.10.0으로 업데이트되었습니다. 이 버전은 번들 수명 주기 런타임 린트 검사를 AGP 버전 9.5.0-alpha04 이상에서 실행하는 데 필요합니다. (I99bfd, b/556807521)
  • AugmentedImage를 구성할 때 최대 이미지 수 0을 확인하여 예기치 않게 실패하는 대신 UnsupportedOperationException를 발생시킵니다. I6ce439
  • 렌더링 작업을 적절하게 추적 및 취소하고, 항목을 삭제하고, 이미지 컬렉션을 안전하게 수정하여 AugmentedImageRenderer의 메모리 누수 및 동시 실행 문제를 해결합니다. Ie70760

버전 1.0

버전 1.0.0

2026년 10월 21일

androidx.xr.arcore:arcore-*:1.0.0이 출시되었습니다. 버전 1.0.0에는 이러한 커밋이 포함되어 있습니다.

1.0.0의 주요 기능:

  • Jetpack XR용 ARCore가 안정화되었습니다. Jetpack XR용 ARCore 라이브러리는 디지털 콘텐츠를 실제 세계와 혼합하는 기능을 제공합니다. 이 라이브러리에는 모션 추적, 영구 앵커, Hit Test, 시맨틱 라벨 지정 (예: 바닥, 벽, 탁자)을 사용한 평면 식별, Google의 시각적 위치 확인 시스템을 사용한 Geospatial 포즈가 포함되어 있습니다.
  • 자세한 내용은 개발자 가이드 및 API 참조를 확인하세요.

버전 1.0.0-rc02

2026년 10월 7일

androidx.xr.arcore:arcore-*:1.0.0-rc02이 출시되었습니다. 버전 1.0.0-rc02에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • 확장 이미지 추적이 지원되지 않을 때 OpenXrRuntime에서 세션을 구성하지 못하는 문제가 해결되었습니다. (I8b9759)
  • applicationContext를 사용하여 XrInstanceManager의 메모리 관리를 개선하고, Session 및 Scene 캐싱 메커니즘을 간소화하여 잠재적인 수명 주기 관련 문제를 해결하고, ReferenceCleaner를 개선하여 스레드 안전 정리 등록 및 명시적 처리를 보장하는 등 여러 문제를 해결했습니다. (Id0b76c)

버전 1.0.0-rc01

2026년 9월 9일

androidx.xr.arcore:arcore-*:1.0.0-rc01이 출시되었습니다. 버전 1.0.0-rc01에 포함된 커밋을 확인하세요.

버전 1.0.0-beta02

2026년 8월 12일

androidx.xr.arcore:arcore-*:1.0.0-beta02이 출시되었습니다. 버전 1.0.0-beta02에 포함된 커밋을 확인하세요.

버그 수정

  • OpenXR 앵커 지속성에서 발생하는 동시 실행 문제를 수정합니다. (I15c8b)
  • 디버깅을 위해 더 많은 클래스에 toString()를 구현했습니다. (I587e8)

버전 1.0.0-beta01

2026년 7월 15일

androidx.xr.arcore:arcore-*:1.0.0-beta01이 출시되었습니다. 버전 1.0.0-beta01에 포함된 커밋을 확인하세요.

API 변경사항

  • 두 개의 수정자 대신 ResizePolicy를 사용하도록 크기 조절 가능한 수정자를 업데이트했습니다. (I7fb0f, b/496257436, b/519672992)
  • movePolicy 매개변수가 있는 이동 가능한 오버로드를 추가하고 transformingMovable 및 movable를 지원 중단했습니다. (Ic88c1, b/481781189)
  • 공개 API 노출 영역에서 TrackingState.TRACKING_DEGRADED를 삭제하고 대신 런타임 성능 저하 상태를 PAUSED에 매핑했습니다. 문자열 변환 및 런타임 변환에 int 값 대신 enum을 사용하도록 TrackingState를 업데이트합니다. (I3eb5b, b/524326338)
  • Session.create를 정지 함수로 변환했습니다. (I5d27f)
  • ProjectedPermissionsResultContract를 지원 중단했습니다. (I141d5, b/515699436)
  • AnchorEntity의 이름이 AnchorSpace로 업데이트되었습니다. (Ifa95e, b/513619219)

버전 1.0.0-alpha15

2026년 6월 17일

androidx.xr.arcore:arcore-*:1.0.0-alpha15이 출시되었습니다. 버전 1.0.0-alpha15에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • HitResult.createAnchor가 삭제되었습니다. 개발자는 결과의 추적 가능한 항목이 Anchorable인 경우 Anchorable의 createAnchor 함수에 히트 위치를 제공하여 HitResult를 나타내는 앵커를 만들 수 있습니다. (Ia851e)
  • AnchorUnsupportedObject가 삭제되었습니다. 더 이상 JXR ARCore 런타임에서 발생하지 않습니다. (Ia851e)
  • 이제 androidx.xr.arcore.Anchor 및 androidx.xr.arcore.ArDevice가 androidx.xr.arcore.Trackable를 구현합니다. (I57b65)
  • Depth.left, Depth.right, Depth.mono는 이제 null을 허용하지 않습니다. (I1fc5e)
  • 이제 Face.getUserFace는 null을 허용하지 않습니다. (I0eac1)
  • thought RenderViewpoint.left, RenderViewpoint.right, RenderViewpoint.mono가 이제 null을 허용하지 않습니다. (Icf7fa)
  • Hand.left 및 Hand.right은 null을 허용하지 않습니다. (Icef37)
  • QrCode API를 추가했습니다. (Ia0bbe)

버전 1.0.0-alpha14

2026년 5월 19일

androidx.xr.arcore:arcore-*:1.0.0-alpha14이 출시되었습니다. 버전 1.0.0-alpha14에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • GeospatialMode.VPS_AND_GPS를 지원 중단하고 GeospatialMode.SPATIAL를 사용하며, IMU와 GPS만 사용하는 새로운 저전력 추적 모드인 GeospatialMode.INERTIAL를 도입합니다. (I1e6cd)
  • 커스텀 앵커 예외 클래스(AnchorInvalidUuidException, AnchorNotAuthorizedException, AnchorUnsupportedLocationException, AnchorRuntimeFailureException, AnchorUnsupportedObjectException)는 이제 RuntimeException 인스턴스이며 확인되지 않습니다. (I9356e)
  • TestArDevice, TestAugmentableObject, TestDepthMap, TestEye, TestFace, TestGeospatial, TestHand, TestPlane, TestRenderViewpoint, TestTrackable를 포함한 ArCoreTestRule API를 추가했습니다. (I0ad3c)
  • AnchorLoadInvalidUuid, AnchorCreateUnsupportedObject, AnchorCreateUnsupportedLocation, AnchorCreateNotAuthorized를 삭제합니다. 이제 이러한 모든 오류는 런타임에서 예외입니다. AnchorCreateIllegalState를 삭제합니다. 대부분의 경우 AnchorCreateTrackingUnavailable로 대체되었습니다. AnchorException 및 파생 클래스 AnchorInvalidUuidException, AnchorNotAuthorizedException, AnchorUnsupportedLocationException, AnchorRuntimeFailureException, AnchorUnsupportedObjectException를 추가합니다. (I4c4dd)

외부 기여

  • 맞춤 마커 추적을 위한 AugmentedImage API를 추가했습니다. (I0cf09)

버전 1.0.0-alpha13

2026년 5월 6일

androidx.xr.arcore:arcore-*:1.0.0-alpha13이 출시되었습니다. 버전 1.0.0-alpha13에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • TrackingState 및 VpsAvailabilityResult가 androidx.xr.arcore package로 이동했으며 androidx.xr.runtime의 유형은 이제 지원 중단되었습니다. (Ic7930, b/480462213)
  • Plane.Type에서 PlaneType로 이름이 변경되었습니다. (I8c90c, b/482675376)
  • Hand.HandSide에서 HandSide로 이름이 변경되었습니다. (Ica562, b/482675376)
  • Plane.Label에서 PlaneLabel로 이름이 변경되었습니다. (Ic6b67, b/482675376)
  • Geospatial.Surface에서 GeospatialSurface로 이름이 변경되었습니다. (I1a8be, b/482675376)
  • Geospatial.State의 이름을 GeospatialState로 변경했습니다. (I203fa, b/482675376)
  • NativeData API를 xr:runtime:runtime 라이브러리로 이동했습니다. (I87954, b/494251500)
  • 이제 Session.create 및 Session.configure는 일부만 포함하며 when 문에 else 절이 필요합니다. (I9885e, b/495805998, b/495805998)
  • androidx.xr.runtime.FieldOfView가 지원 중단되었습니다. 대신 androidx.xr.runtime.math.FieldOfView를 사용합니다. (Ia01a0, b/480233045)
  • 위치, 오프셋, offsetType, 정렬, 고도 대신 OrbiterAnchorPoint + VolumeOffset 또는 OrbiterPoseProvider를 사용하도록 Orbiter를 변경했습니다. shouldRenderInNonSpatial 매개변수도 삭제했습니다. 개발자가 오비터를 비공간으로 렌더링하지 않으려면 오비터를 if 문으로 래핑하고 SpatialCapabilities를 확인해야 합니다. (I9fbb3, b/462428503)
  • 이동 가능한 수정자가 추가되었습니다. 이러한 수정자는 현재 SpatialPanels 및 SpatialExternalSurface에서 잘 작동합니다. 곧 SpatialGltfModels에서도 지원될 예정입니다. 하지만 모든 SubspaceComposables에서 이러한 기능이 제대로 지원되도록 하는 것이 목표입니다. (I9a3cd, b/479530787, b/478935063, b/478935063)
  • 개발자는 ArDevice.state Flow를 관찰하여 State.trackingState를 모니터링하고 추적 충실도에 따라 애플리케이션의 렌더링 또는 경고를 조정해야 합니다. (Ic00f0, b/445466590)
  • HandJointType enum 값의 이름을 바꿨습니다. (Ifbc83, b/482670596)
  • FaceConfidenceRegion 상수의 이름을 변경했습니다. (Ia62d5, b/482670596)
  • FaceBlendShapeType 상수의 이름을 변경했습니다. (I33b8b, b/482670596)
  • CreatePoseFromGeospatialPoseErrorInternal 및 CreateGeospatialPoseFromPoseErrorInternal를 추가했습니다. (I4bcf1, b/482666615)
  • DeviceTrackingMode.LAST_KNOWN의 이름을 SPATIAL_LAST_KNOWN로 변경하고 (지원 중단된 대체 포함), 3DoF 추적을 위해 INERTIAL_LAST_KNOWN를 추가하고, TrackingState에 TRACKING_DEGRADED를 추가했습니다. (Ie661c, b/445466590)
  • GroupEntity가 지원 중단되었습니다. 기본 Entity 기능만 있는 Entity를 사용하려면 Entity.create를 호출합니다. 그러면 Entity 인터페이스가 반환됩니다. (I4c450, b/473867483)
  • XrLog API를 추가했습니다. XrLog.isEnabled를 true로 설정하여 JetpackXR에서 로깅을 사용 설정하고 XrLog.Level를 사용하여 로그 수준을 설정합니다. (I76a1f, b/463460895, b/487378441)

버그 수정

  • openxr 기기에 기기 추적 상태 지원을 추가합니다. (I91485, b/445466590)

버전 1.0.0-alpha12

2026년 3월 25일

androidx.xr.arcore:arcore-*:1.0.0-alpha12이 출시되었습니다. 버전 1.0.0-alpha12에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • Config.augmentedObjectCategories를 목록에서 세트로 변경했습니다. (I25a64, b/487376359)
  • androidx.xr.arcore.Eye 및 androidx.xr.arcore.Hand 유형 (I42438, b/449032900)
  • 리소스 범위 지정을 위해 Android 컨텍스트를 전달할 수 있도록 Session.create 오버로드를 추가했습니다. (I7d3fe, b/415805990, b/477386334)
  • FakeRuntimeAnchor.ANCHOR_RESOURCE_LIMIT을 FakeRuntimeAnchor.anchorResourceLimit로 변경합니다. (I90841, b/431992235)
  • TiltGesture API는 향후 변경되거나 삭제될 수 있으므로 실험용으로 설정합니다. 이 API를 사용하려면 @ExperimentalGesturesApi을 선택하세요. (Ic9858)
  • 구성에서 AugmentedObject 추적 카테고리를 설정하는 기능이 추가되었습니다. (I1f6e4, b/480220930)

버그 수정

  • PerceptionRuntimeFactory의 실제 위치로 META-INF/services/ 파일을 업데이트하여 Chrome 빌드를 수정했습니다. (I7a801, b/481288291)

버전 1.0.0-alpha11

2026년 2월 25일

androidx.xr.arcore:arcore-*:1.0.0-alpha11이 출시되었습니다. 버전 1.0.0-alpha11에는 이러한 커밋이 포함되어 있습니다.

버전 1.0.0-alpha10

2026년 1월 28일

androidx.xr.arcore:arcore-*:1.0.0-alpha10이 출시되었습니다. 버전 1.0.0-alpha10에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • TiltGesture API를 도입하여 전환 진행 상황과 함께 기기 기울기 (UP/DOWN) 상태를 안정적으로 감지하는 반응형 Flow를 제공합니다. (Ic269f, b/448152779)
  • Jetpack XR용 ARCore가 이제 XR 런타임 로깅 메커니즘을 사용합니다. 자세한 내용은 androidx.xr.runtime.Log를 참고하세요. (l52735, b/448697662)

API 변경사항

  • 이제 OpenXR 지원 기기에서 Geospatial.createPoseFromGeospatialPose가 작동합니다. (l362c6)

버전 1.0.0-alpha09

2025년 12월 3일

androidx.xr.arcore:arcore-*:1.0.0-alpha09이 출시되었습니다. 버전 1.0.0-alpha09에는 이러한 커밋이 포함되어 있습니다.

버전 1.0.0-alpha08

2025년 11월 19일

androidx.xr.arcore:arcore-*:1.0.0-alpha08이 출시되었습니다. 버전 1.0.0-alpha08에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • 이제 Jetpack XR용 ARCore에서 Google Play AR 서비스를 사용할 수 있는 기기를 지원합니다.
  • VPS 가용성 및 포즈 변환을 위한 Geospatial API를 추가했습니다. (I144dc)

버전 1.0.0-alpha07

2025년 10월 22일

androidx.xr.arcore:arcore-*:1.0.0-alpha07이 출시되었습니다. 버전 1.0.0-alpha07에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • :xr:arcore:arcore-openxr가 :xr:arcore:arcore에 구현 종속 항목으로 추가되었습니다. (I47315, b/446999229)

버전 1.0.0-alpha06

2025년 9월 24일

androidx.xr.arcore:arcore-*:1.0.0-alpha06이 출시되었습니다. 버전 1.0.0-alpha06에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • ARCore에 대한 테스트 지원이 xr:arcore:arcore-testing 모듈로 이전되었습니다. (I25469)
  • 애플리케이션이 렌더링 목적으로 기기의 포즈 및 디스플레이 구성을 가져올 수 있도록 ArDevice 및 RenderViewpoint를 추가합니다. (Ib7e3f)
  • HandJointType enum의 이름을 HAND_JOINT_TYPE_ 접두사로 바꿉니다. (I3f7cd)
  • HandJointType이(가) xr:runtime:runtime에서 xr:arcore:arcore(으)로 이동되었습니다. (Iadb9c, b/409058039)
  • Hand.State는 이제 성능 지향 애플리케이션에 쉽게 액세스할 수 있는 형식으로 관절 포즈가 포함된 java.nio.FloatBuffer를 노출합니다. (I55e27)

버전 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에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • 개발자가 손 방향 정보를 가져올 수 있도록 getPrimaryHandSide를 추가합니다 (I270bd).
  • Geospatial VPS 사용 가능 여부 확인 API 추가 (I58573)
  • checkVpsAvailability용 ARCore API 추가 (Idbded)
  • Java 개발자가 사용할 수 있도록 stateFlowable 확장 함수가 :xr:arcore:arcore-rxjava3에 추가되었습니다. (I083aa, b/427247794)

API 변경사항

  • 구성 *Mode 값이 동작을 반영하도록 이름이 변경되었습니다. (I6d247, b/414648065)
  • thought 기본 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 개발자가 사용할 수 있도록 Anchor.persistAsync()가 AnchorGuava에 추가되었습니다. (I4af1c, b/425984631)
  • Java 개발자가 사용할 수 있도록 Earth.createAnchorOnSurfaceAsync(Session, Double, Double, Double, Quaternion, Surface)가 EarthGuava에 추가되었습니다. (I66357, b/425992992)
  • Java 개발자는 GltfModel.kt에서 GltfModel.createAsync의 확장 함수를 사용합니다. GltfModel의 비동기 함수가 삭제됩니다. (I0af60)
  • 이제 이 라이브러리는 유형 사용인 JSpecify nullness 주석을 사용합니다. Kotlin 개발자는 올바른 사용을 위해 컴파일러 인수 -Xjspecify-annotations=strict를 사용해야 합니다 (Kotlin 컴파일러 버전 2.1.0부터 기본값임). (Ia8420, b/326456246)
  • Java 개발자가 사용할 수 있도록 subscribeAsFlowable 확장 함수가 :xr:arcore:arcore-rxjava3에 추가되었습니다. (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)
  • thought 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 라이브러리에서 영감을 받은 Jetpack XR용 ARCore 라이브러리는 디지털 콘텐츠를 실제 세계와 혼합하는 기능을 제공합니다. 이 라이브러리에는 모션 추적, 영구 앵커, Hit Test, 시맨틱 라벨 지정 (예: 바닥, 벽, 탁자)을 통한 평면 식별이 포함됩니다. Jetpack XR용 ARCore 사용에 관한 자세한 내용은 개발자 가이드를 참고하세요.

  • Session: Jetpack XR용 ARCore는 내부적으로 Jetpack XR 런타임을 사용하여 기능을 지원합니다. 세션을 사용하여 대부분의 Jetpack XR용 ARCore 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 블록으로 래핑하는 것이 좋습니다.