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 release 1.31 di maggio 2022, la portata massima della profondità di ARCore è stata aumentata da 8,191 metri a 65,535 metri. L'API depth ora utilizza tutti i 16 bit per pixel per rappresentare la profondità, dove in precedenza erano utilizzati solo 13 bit per i valori di profondità. Anche se le app che utilizzano i seguenti metodi negli SDK ARCore precedenti continueranno a funzionare con l'intervallo di profondità precedente, ti consigliamo di aggiornarle nel codebase per una migliore funzionalità.

Modifiche specifiche della piattaforma

Android (Kotlin/Java)

Nomi e funzionalità 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)

Nomi e funzionalità 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 (Fondazione AR)

Tutte le modifiche vengono 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.