Le modifiche descritte in questo documento si applicano solo alle app compilate con la versione 1.31 o successive dell'SDK ARCore. Le app compilate con una versione precedente di ARCore non saranno interessate.
Nell'ambito della release 1.31 di maggio 2022, l'intervallo massimo della profondità di ARCore è stato aggiornato da 8,191 metri a 65,535 metri. L'API Depth ora utilizza tutti i 16 bit per pixel per rappresentare la profondità, mentre in precedenza venivano utilizzati solo 13 bit per i valori di profondità. Sebbene le app che utilizzano i seguenti metodi negli SDK ARCore precedenti continueranno a funzionare utilizzando l'intervallo di profondità precedente, ti consigliamo di aggiornarli nel codebase per una migliore funzionalità.
Modifiche specifiche della piattaforma
Android (Kotlin/Java)
| Nomi e funzionalità dei metodi precedenti | Nomi e funzionalità dei nuovi metodi |
|---|---|
| Intervallo massimo di 8,191 metri | Intervallo massimo di 65,535 metri |
Frame.acquireDepthImage() |
Frame.acquireDepthImage16Bits() |
Frame.acquireRawDepthImage() |
Frame.acquireRawDepthImage16Bits() |
Image.getFormat() restituisce ImageFormat.DEPTH16 |
Image.getFormat() restituisce HardwareBuffer.D_16 |
Android NDK (C)
| Nomi e funzionalità dei metodi precedenti | Nomi e funzionalità dei nuovi metodi |
|---|---|
| Intervallo massimo di 8,191 metri | Intervallo massimo di 65,535 metri |
ArFrame_acquireDepthImage() |
ArFrame_acquireDepthImage16Bits() |
ArFrame_acquireRawDepthImage() |
ArFrame_acquireRawDepthImage16Bits() |
ArImage_getFormat() restituisce AR_IMAGE_FORMAT_DEPTH16 |
ArImage_getFormat() restituisce AR_IMAGE_FORMAT_D_16 |
Unity (AR Foundation)
Tutte le modifiche vengono gestite da AR Foundation. Quando crei con le estensioni ARCore per AR Foundation versione 1.31 o successive, AROcclusionManager.TryAcquireEnvironmentDepthCpuImage restituisce immagini utilizzando il nuovo intervallo massimo di 65,535 metri.