Abandon des méthodes d'appareil photo en novembre 2022 pour le SDK ARCore pour le NDK Android (C)

En novembre 2022, les services Google Play pour la RA supprimeront les méthodes obsolètes liées aux images et aux métadonnées de l'appareil photo du NDK.

Les applications qui utilisent ces méthodes dans les versions concernées du SDK ARCore peuvent commencer à se comporter différemment ou planter lorsque les utilisateurs mettent à jour les Services Google Play pour la RA.

Applications concernées

À partir de novembre 2022, votre application risque de cesser de fonctionner ou de planter lorsque les utilisateurs passeront à la dernière version des Services Google Play pour la RA si:

Votre application a été compilée avec un SDK concerné
Votre application utilise l'une des API concernées suivantes:

Si votre application a été compilée avec la version du SDK ARCore :	et utilise les API concernées :	Comportement de non-fonctionnement à partir de novembre 2022
1.22.0 ou version antérieure	`ArImage_getNdkImage()` (supprimé dans le SDK ARCore 1.23.0)	Renvoie `NULL` dans la structure `AImage` générée.
1.22.0 ou version antérieure	`ArImage_getNdkCameraMetadata()` (supprimé dans le SDK ARCore 1.23.0)	Renvoie `NULL` dans la structure `ACameraMetadata` générée.

Corriger les applications concernées

Les applications concernées risquent de ne plus fonctionner en novembre 2022. Pour atténuer ce problème, utilisez des remplacements prêts à l'emploi pour les méthodes concernées:

Méthodes ArImage_getNdkImage() et AImage_*: utilisez les méthodes correspondantes de ArImage. Exemple :
- AImage_getNumberOfPlanes() devient ArImage_getNumberOfPlanes()
- AImage_getPlaneData() devient ArImage_getPlaneData()
ArImage_getNdkCameraMetadata(): utilisez plutôt ArImageMetadata_getConstEntry()

Vérifier que l'application concernée est corrigée

Testez l'application en simulant à l'avance les modifications de novembre 2022 en ajoutant une entrée meta-data spéciale à la AndroidManifest.xml de votre application:

Assurez-vous que la version 1.29.0 ou ultérieure de Play Services pour la RA est installée sur l'appareil cible.

Ajoutez une balise <meta-data> en tant qu'enfant de l'élément <application> existant dans le fichier AndroidManifest.xml de l'application :

<application …>
  …

  <!--
       Simulate the November 2022 changes in advance.
       IMPORTANT: Remove this tag when testing is completed.
       Do not include this tag in published versions of your app.
  -->
  <meta-data android:name="com.google.ar.core.session_settings"
             android:value="camera_stack_option,unified_mono" />
</application>

Testez votre application et vérifiez que toutes les fonctionnalités ARCore fonctionnent comme prévu.
Supprimez la balise <meta-data> une fois les tests terminés. Laisser cette balise dans votre application publiée pourrait entraîner un comportement inattendu à l'avenir.

Si l'application fonctionne normalement, elle est prête pour les modifications de novembre 2022.

Chronologie

Période	Événements
Novembre 2020 (version 1.20.0 du SDK ARCore)	Abandon des API concernées, introduction d'API alternatives prêtes à l'emploi.
Février 2021 (SDK ARCore 1.23.0)	Suppression des signatures d'API précédemment obsolètes du SDK ARCore.
Novembre 2021	Annonce d'un futur changement destructif en raison de la suppression en attente de l'implémentation des API concernées des Services Google Play pour la RA en novembre 2022.
Novembre 2022	Supprimez l'implémentation des API concernées des Services Google Play pour la RA. Introduit une modification importante pour les applications qui utilisent des versions d'ARCore antérieures à la version 1.23.0.