이 문서에 설명된 변경사항은 ARCore SDK 버전 1.31 이상으로 컴파일된 앱에만 적용됩니다. 이전 버전의 ARCore로 컴파일된 앱은 영향을 받지 않습니다.
2022년 5월 1.31 출시의 일환으로 ARCore의 최대 깊이가 8.191미터에서 65.535미터로 업그레이드되었습니다. Depth API는 이제 모든 픽셀당 16비트를 사용하여 깊이를 표현하지만, 이전에는 13비트만 깊이 값에 사용되었습니다. 이전 ARCore SDK에서 다음 메서드를 사용하는 앱은 여전히 이전 깊이 범위를 사용하여 작동하지만 더 나은 기능을 위해 코드베이스에서 업데이트하는 것이 좋습니다.
플랫폼별 변경사항
Android (Kotlin/자바)
| 이전 메서드 이름 및 기능 | 새로운 메서드 이름 및 기능 |
|---|---|
| 최대 범위 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 재단에서 처리합니다. AR Foundation용 ARCore 확장 프로그램 버전 1.31 이상을 사용하여 빌드하는 경우 AROcclusionManager.TryAcquireEnvironmentDepthCpuImage는 새로운 최대 범위 65.535m를 사용하여 이미지를 반환합니다.