Les modifications décrites dans ce document ne s'appliquent qu'aux applications compilées avec le SDK ARCore version 1.31 ou ultérieure. Les applications compilées avec une ancienne version d'ARCore ne seront pas affectées.
Dans la version 1.31 de mai 2022, la plage maximale de profondeur d'ARCore est passée de 8,191 mètres à 65,535 mètres. L'API Depth utilise désormais les 16 bits par pixel pour représenter la profondeur, alors qu'auparavant, seuls 13 bits étaient utilisés pour les valeurs de profondeur. Bien que les applications utilisant les méthodes suivantes dans les anciens SDK ARCore continuent de fonctionner avec l'ancienne plage de profondeur, nous vous recommandons de les mettre à jour dans votre code pour une meilleure fonctionnalité.
Modifications spécifiques à la plate-forme
Android (Kotlin/Java)
| Anciens noms de méthodes et fonctionnalités | Nouveaux noms de méthodes et nouvelles fonctionnalités |
|---|---|
| Portée maximale de 8 191 mètres | Portée maximale de 65 535 mètres |
Frame.acquireDepthImage() |
Frame.acquireDepthImage16Bits() |
Frame.acquireRawDepthImage() |
Frame.acquireRawDepthImage16Bits() |
Image.getFormat() renvoie ImageFormat.DEPTH16 |
Image.getFormat() renvoie HardwareBuffer.D_16 |
NDK Android (C)
| Anciens noms de méthodes et fonctionnalités | Nouveaux noms de méthodes et nouvelles fonctionnalités |
|---|---|
| Portée maximale de 8 191 mètres | Portée maximale de 65 535 mètres |
ArFrame_acquireDepthImage() |
ArFrame_acquireDepthImage16Bits() |
ArFrame_acquireRawDepthImage() |
ArFrame_acquireRawDepthImage16Bits() |
ArImage_getFormat() renvoie AR_IMAGE_FORMAT_DEPTH16 |
ArImage_getFormat() renvoie AR_IMAGE_FORMAT_D_16 |
Unity (AR Foundation)
Toutes les modifications sont gérées par AR Foundation. Lorsque vous créez des applications avec les extensions ARCore pour AR Foundation version 1.31 ou ultérieure, AROcclusionManager.TryAcquireEnvironmentDepthCpuImage renvoie des images utilisant la nouvelle plage maximale de 65 535 mètres.