As mudanças descritas neste documento só são aplicáveis 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 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, que anteriormente 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 de métodos e funcionalidades 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 de métodos e funcionalidades 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 a ARCore Extensions for AR Foundation versão 1.31 ou mais recente, o AROcclusionManager.TryAcquireEnvironmentDepthCpuImage retorna imagens usando o novo alcance máximo de 65,535 metros.