Los cambios que se describen en este documento solo se aplican a las apps compiladas con el SDK de ARCore versión 1.31 o posterior. Las apps compiladas con una versión anterior de ARCore no se verán afectadas.
Como parte de la versión 1.31 de mayo de 2022, se actualizó el rango máximo de profundidad de ARCore de 8.191 a 65.535 metros. La API de Depth ahora usa los 16 bits por píxel para representar la profundidad, mientras que antes solo se usaban 13 bits para los valores de profundidad. Si bien las apps que usan los siguientes métodos en los SDK de ARCore más antiguos seguirán funcionando con el rango de profundidad anterior, te recomendamos que las actualices en tu base de código para mejorar la funcionalidad.
Cambios específicos de la plataforma
Android (Kotlin/Java)
| Funcionalidades y nombres de métodos anteriores | Nuevos nombres y funcionalidades de métodos |
|---|---|
| Rango máximo de 8.191 metros | Rango máximo de 65.535 metros |
Frame.acquireDepthImage() |
Frame.acquireDepthImage16Bits() |
Frame.acquireRawDepthImage() |
Frame.acquireRawDepthImage16Bits() |
Image.getFormat() muestra ImageFormat.DEPTH16 |
Image.getFormat() muestra HardwareBuffer.D_16 |
NDK de Android (C)
| Funcionalidades y nombres de métodos anteriores | Nuevos nombres y funcionalidades de métodos |
|---|---|
| Rango máximo de 8.191 metros | Rango máximo de 65.535 metros |
ArFrame_acquireDepthImage() |
ArFrame_acquireDepthImage16Bits() |
ArFrame_acquireRawDepthImage() |
ArFrame_acquireRawDepthImage16Bits() |
ArImage_getFormat() muestra AR_IMAGE_FORMAT_DEPTH16 |
ArImage_getFormat() muestra AR_IMAGE_FORMAT_D_16 |
Unity (AR Foundation)
AR Foundation se encarga de todos los cambios. Cuando compilas con Extensiones de ARCore para la versión 1.31 o posterior de AR Foundation, AROcclusionManager.TryAcquireEnvironmentDepthCpuImage muestra imágenes con el nuevo rango máximo de 65.535 metros.