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 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 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 con l'intervallo di profondità precedente, ti consigliamo di aggiornarli nella base di codice per una funzionalità migliore.
Modifiche specifiche della piattaforma
Android (Kotlin/Java)
| Nomi e funzionalità dei metodi precedenti | Nuovi nomi e funzionalità dei metodi |
|---|---|
| Raggio massimo 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 |
|---|---|
| Raggio massimo di 8.191 metri | Raggio 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 sono gestite da AR Foundation. Quando esegui la compilazione con ARCore Extensions per AR Foundation versione 1.31 o successive, AROcclusionManager.TryAcquireEnvironmentDepthCpuImage restituisce le immagini utilizzando la nuova portata massima di 65.535 metri.