Les modifications décrites dans ce document ne s'appliquent qu'aux applications compilées avec la version 1.31 ou ultérieure du SDK ARCore. 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 que seuls 13 bits étaient auparavant utilisés pour les valeurs de profondeur. Bien que les applications qui utilisent les méthodes suivantes dans les anciens SDK ARCore continuent de fonctionner avec la plage de profondeur précédente, nous vous recommandons de les mettre à jour dans votre codebase pour améliorer leur fonctionnalité.
Modifications spécifiques à la plate-forme
Android (Kotlin/Java)
| Noms et fonctionnalités des méthodes précédentes | Nouveaux noms de méthode 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éthode 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 à l'aide de la nouvelle portée maximale de 65,535 mètres.