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, enquanto 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étodo e funcionalidade |
|---|---|
| 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étodo e funcionalidade |
|---|---|
| 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 tratadas pela Fundação AR. Ao criar com as extensões do ARCore para a versão 1.31 ou mais recente da AR Foundation, o AROcclusionManager.TryAcquireEnvironmentDepthCpuImage retorna imagens usando o novo alcance máximo de 65,535 metros.