Modifiche alla profondità di maggio 2022 (SDK ARCore versione 1.31)

Le modifiche descritte in questo documento si applicano solo alle app compilate con l'SDK ARCore 1.31 o versioni successive. Le app compilate con una versione precedente di ARCore non saranno interessate.

Nell'ambito della versione 1.31 di maggio 2022, la portata massima della profondità di ARCore è stata aggiornata 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 per i valori di profondità venivano utilizzati solo 13 bit. Anche se le app che utilizzano i seguenti metodi negli SDK ARCore meno recenti continueranno a funzionare con l'intervallo di profondità precedente, ti consigliamo di aggiornarle nel tuo codebase per una migliore funzionalità.

Modifiche specifiche per piattaforma

Android (Kotlin/Java)

Funzionalità e nomi dei metodi precedenti Nuovi nomi e funzionalità dei metodi
Portata massima di 8,191 metri Portata massima 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)

Funzionalità e nomi dei metodi precedenti Nuovi nomi e funzionalità dei metodi
Portata massima di 8,191 metri Portata massima 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 (Elementi di base AR)

Tutte le modifiche sono gestite da AR Foundation. Quando crei con ARCore Extensions per AR Foundation versione 1.31 o successive, AROcclusionManager.TryAcquireEnvironmentDepthCpuImage restituisce le immagini utilizzando il nuovo raggio massimo di 65,535 metri.