Modification de la profondeur en mai 2022 (version 1.31 du SDK ARCore)

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 portée maximale 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 que seuls 13 bits étaient auparavant utilisés pour les valeurs de profondeur. Les applications utilisant les méthodes suivantes dans les SDK ARCore plus anciens continueront de fonctionner avec la plage de profondeurs précédente. Toutefois, nous vous recommandons de les mettre à jour dans votre codebase pour de meilleures fonctionnalités.

Modifications spécifiques à une plate-forme

Android (Kotlin/Java)

Noms et fonctionnalités des méthodes précédentes 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

Android NDK (C)

Noms et fonctionnalités des méthodes précédentes 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 (fondation de RA)

Toutes les modifications sont gérées par AR Foundation. Lorsque vous créez des applications avec des extensions ARCore pour AR Foundation version 1.31 ou ultérieure, AROcclusionManager.TryAcquireEnvironmentDepthCpuImage renvoie des images en utilisant la nouvelle portée maximale de 65,535 mètres.