Cambios en Depth de mayo de 2022 (versión 1.31 del SDK de ARCore)

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, el rango máximo de profundidad de ARCore se actualizó 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 SDKs de ARCore anteriores 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)

Nombres y funciones de métodos anteriores Nombres y funciones de métodos nuevos
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 Nombres y funciones de métodos nuevos
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 se compila con extensiones de ARCore para AR Foundation versión 1.31 o posterior, AROcclusionManager.TryAcquireEnvironmentDepthCpuImage muestra imágenes con el nuevo rango máximo de 65,535 metros.