이 문서에 설명된 변경사항은 ARCore SDK 버전 1.31 이상으로 컴파일된 앱에만 적용됩니다. 이전 버전의 ARCore로 컴파일된 앱은 영향을 받지 않습니다.
2022년 5월 1.31 출시의 일환으로 ARCore의 최대 깊이 범위가 8.191미터에서 65.535미터로 업그레이드되었습니다. 이전에는 깊이 값에 13비트만 사용되었던 Depth API가 이제 픽셀당 16비트를 모두 사용하여 깊이를 나타냅니다. 이전 ARCore SDK에서 다음 메서드를 사용하는 앱은 여전히 이전 깊이 범위를 사용하여 작동하지만 더 나은 기능을 위해 코드베이스에서 업데이트하는 것이 좋습니다.
플랫폼별 변경사항
Android (Kotlin/Java)
| 이전 메서드 이름 및 기능 | 새로운 메서드 이름 및 기능 |
|---|---|
| 최대 범위: 8.191m | 최대 범위 65.535m |
Frame.acquireDepthImage() |
Frame.acquireDepthImage16Bits() |
Frame.acquireRawDepthImage() |
Frame.acquireRawDepthImage16Bits() |
Image.getFormat()은 ImageFormat.DEPTH16을 반환합니다. |
Image.getFormat()은 HardwareBuffer.D_16을 반환합니다. |
Android NDK (C)
| 이전 메서드 이름 및 기능 | 새로운 메서드 이름 및 기능 |
|---|---|
| 최대 범위: 8.191m | 최대 범위 65.535m |
ArFrame_acquireDepthImage() |
ArFrame_acquireDepthImage16Bits() |
ArFrame_acquireRawDepthImage() |
ArFrame_acquireRawDepthImage16Bits() |
ArImage_getFormat()은 AR_IMAGE_FORMAT_DEPTH16을 반환합니다. |
ArImage_getFormat()은 AR_IMAGE_FORMAT_D_16을 반환합니다. |
Unity (AR Foundation)
모든 변경사항은 AR Foundation에서 처리합니다. AR Foundation 버전 1.31 이상용 ARCore 확장 프로그램으로 빌드할 때 AROcclusionManager.TryAcquireEnvironmentDepthCpuImage는 새로운 최대 범위인 65.535미터를 사용하여 이미지를 반환합니다.