As mudanças descritas neste documento são aplicáveis apenas a apps compilados com o SDK do ARCore versão 1.31 ou mais recente. Os apps compilados com uma versão mais antiga do ARCore não vão ser afetados.
Como parte da versão 1.31 de maio de 2022, o alcance máximo de 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 métodos a seguir 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 funcionalidade 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 funcionalidade 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 (fundação de RA)
Todas as mudanças são processadas pela AR Foundation. Ao criar com extensões do ARCore para AR Foundation versão 1.31 ou mais recente, o AROcclusionManager.TryAcquireEnvironmentDepthCpuImage retorna imagens usando o novo alcance máximo de 65,535 metros.