Les modifications décrites dans ce document ne s'appliquent qu'aux applications compilées avec le SDK ARCore 1.31 ou version 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 de la 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 SDK ARCore plus anciens continueront de fonctionner avec la plage de profondeur précédente, nous vous recommandons de les mettre à jour dans votre codebase pour améliorer leurs fonctionnalités.
Modifications spécifiques à la 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 |
NDK Android (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 (AR Foundation)
Toutes les modifications sont gérées par AR Foundation. Lors de la compilation avec les 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.