As mudanças descritas neste documento só se aplicam a apps compilados com a versão 1.31 ou mais recente do SDK do ARCore. Os apps compilados com uma versão mais antiga do ARCore não serão afetados.
Como parte da versão 1.31 de maio de 2022, o alcance máximo da profundidade do ARCore foi atualizado de 8.191 metros para 65.535 metros. A API Depth agora usa todos os 16 bits por pixel para representar a profundidade. Antes, apenas 13 bits eram usados para valores de profundidade. Embora os apps que usam os seguintes métodos em SDKs do ARCore mais antigos ainda funcionem com o intervalo de profundidade anterior, recomendamos atualizá-los na sua base de código para melhorar a funcionalidade.
Mudanças específicas da plataforma
Android (Kotlin/Java)
| Nomes e funcionalidades de métodos anteriores | Novos nomes de métodos e funcionalidades |
|---|---|
| Alcance máximo de 8.191 metros | Alcance máximo de 65.535 metros |
Frame.acquireDepthImage() |
Frame.acquireDepthImage16Bits() |
Frame.acquireRawDepthImage() |
Frame.acquireRawDepthImage16Bits() |
Image.getFormat() retorna ImageFormat.DEPTH16 |
Image.getFormat() retorna HardwareBuffer.D_16 |
Android NDK (C)
| Nomes e funcionalidades de métodos anteriores | Novos nomes de métodos e funcionalidades |
|---|---|
| Alcance máximo de 8.191 metros | Alcance máximo de 65.535 metros |
ArFrame_acquireDepthImage() |
ArFrame_acquireDepthImage16Bits() |
ArFrame_acquireRawDepthImage() |
ArFrame_acquireRawDepthImage16Bits() |
ArImage_getFormat() retorna AR_IMAGE_FORMAT_DEPTH16 |
ArImage_getFormat() retorna AR_IMAGE_FORMAT_D_16 |
Unity (AR Foundation)
Todas as mudanças são processadas pelo AR Foundation. Ao criar com as extensões do ARCore para a versão 1.31 ou mais recente do AR Foundation, o AROcclusionManager.TryAcquireEnvironmentDepthCpuImage retorna imagens usando o novo alcance máximo de 65.535 metros.