Los cambios descritos en este documento solo se aplican a 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 mejoró el rango máximo de profundidad de ARCore de 8.191 metros 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 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 (Base de RA)
AR Foundation se encarga de todos los cambios. Cuando compiles con Extensiones de ARCore para AR Foundation versión 1.31 o posterior, AROcclusionManager.TryAcquireEnvironmentDepthCpuImage mostrará imágenes con el nuevo rango máximo de 65.535 metros.