Activer la RA dans l'application AR Foundation (Android uniquement)

Activez la RA pour utiliser les fonctionnalités de réalité augmentée dans votre application nouvelle ou existante.

Configurez votre application pour que la RA soit obligatoire ou facultative pour votre application

Pour économiser de l'espace sur des appareils individuels, toutes les fonctionnalités de RA sont stockées dans une application appelée Services Google Play pour la RA, mise à jour séparément par le Play Store. Les applications Android qui utilisent des fonctionnalités de RA communiquent avec les services Google Play pour la RA à l'aide du SDK ARCore. Une application compatible avec les fonctionnalités de RA peut être configurée de deux manières: RA requise et RA facultative. Cette désignation détermine la manière dont l'application interagit avec l'application Services Google Play pour la RA.

Une application AR requise ne peut pas fonctionner sans ARCore. Vous devez disposer d'un appareil compatible ARCore sur lequel les services Google Play pour la RA sont installés.

  • Les applis du Google Play Store ne sont disponibles que sur les appareils compatibles avec ARCore.
  • Lorsque les utilisateurs installent une application requise pour la RA, le Google Play Store installe automatiquement les Services Google Play pour la RA sur leur appareil. Toutefois, votre application doit toujours effectuer des vérifications d'exécution supplémentaires au cas où les services Google Play pour la RA ne seraient plus à jour ou auraient été désinstallés manuellement.

Une application facultative utilise ARCore pour améliorer les fonctionnalités existantes. Elle offre des fonctionnalités de RA facultatives qui ne sont activées que sur les appareils compatibles ARCore sur lesquels les services Google Play pour la RA sont installés.

  • Les applications facultatives de RA peuvent être installées et exécutées sur des appareils non compatibles avec ARCore.
  • Lorsque les utilisateurs installent une application facultative en RA, le Google Play Store n'installe pas automatiquement les Services Google Play pour la RA sur l'appareil.
RA requiseRA (facultatif)
Utilisation des fonctionnalités de RA Votre application a besoin d'ARCore pour les fonctionnalités de base. ARCore améliore les fonctionnalités de votre application. Votre application peut s'exécuter sans compatibilité avec ARCore.
Visibilité sur le Play Store Votre application n'est listée sur le Play Store que sur les appareils compatibles avec ARCore. Votre application suit les procédures habituelles d'ajout de fiches.
Méthode d'installation des Services Google Play pour la RA Le Play Store installe les services Google Play pour la RA en même temps que votre application. Votre application utilise ARSession.state pour télécharger et installer ARCore.
Configuration requise pour Android minSdkVersion Android 7.0 (niveau d'API 24) Android 4.4 (niveau d'API 19), bien que l'exécution de toute fonctionnalité de RA nécessite au moins Android 7.0 (niveau d'API 24)
Vous devez utiliser ARSession.state pour vérifier la compatibilité avec ARCore et l'état de l'installation

Rendre la RA requise pour votre application

Android

  1. Accédez à Edit > Project Settings > XR Plug-in Management > ARCore. Requirement est défini sur Required par défaut.

  2. Cliquez sur Edit > Project Settings > Player, puis sélectionnez l'onglet avec l'icône Android.

  3. Sous Other Settings > Identification, spécifiez une valeur Minimum API Level supérieure ou égale à 24.

iOS

  1. Accédez à Edit > Project Settings > XR Plug-in Management > ARKit. Requirement est défini sur Required par défaut.

  2. Cliquez sur Edit > Project Settings > Player, puis sélectionnez l'onglet avec l'icône iOS.

  3. Sous Other Settings > Configuration, spécifiez l'élément Target minimum iOS Version de votre application.

Rendre la RA facultative pour votre application

Android

  1. Accédez à Edit > Project Settings > XR Plug-in Management > ARCore.

  2. Dans le menu déroulant Requirement, sélectionnez Optional pour définir votre application sur la RA si vous le souhaitez.

  3. Cliquez sur Edit > Project Settings > Player, puis sélectionnez l'onglet avec l'icône Android.

  4. Sous Other Settings > Identification, spécifiez une valeur Minimum API Level supérieure ou égale à 24.

iOS

  1. Accédez à Edit > Project Settings > XR Plug-in Management > ARKit.

  2. Dans le menu déroulant Requirement, sélectionnez Optional pour définir votre application sur "RA" (facultatif).

  3. Cliquez sur Edit > Project Settings > Player, puis sélectionnez l'onglet avec l'icône iOS.

  4. Sous Other Settings > Configuration, spécifiez l'élément Target minimum iOS Version de votre application.

Effectuer des vérifications d'exécution

Vérifier si Services Google Play pour la RA est installé

Les applications RA requise et RA Optional doivent appeler ARSession.state avant de créer une session ARCore afin de vérifier si une version compatible des Services Google Play pour la RA est installée (toujours) et de s'assurer que toutes les données de profil de l'appareil ARCore requises ont été téléchargées.

Pendant l'exécution, les applications avec RA requise effectuent automatiquement des vérifications d'exécution pour s'assurer que l'appareil cible:

  • Compatible avec ARCore
  • a installé Google Play Services for AR : si elle n'est pas installée (peut-être parce qu'elle a été supprimée par l'utilisateur) ou si la version est trop ancienne, votre application invite l'utilisateur à l'installer ou à la mettre à jour.
  • Dispose de données de profil d'appareil ARCore à jour. Si elles sont obsolètes, votre application téléchargera les nouvelles données.

Définissez ARSession.attemptUpdate sur false pour désactiver ces vérifications par défaut. Votre application doit toujours gérer les conditions suivantes:

Condition Action
L'appareil n'est pas compatible avec ARCore. Masque les fonctionnalités liées à la RA.
L'appareil est compatible avec ARCore, mais les données de profil Google Play Services for AR et/ou ARCore ne sont pas installées ou sont obsolètes. Invite l'utilisateur à installer ou mettre à jour les données de profil d'appareil Google Play Services for AR et/ou ARCore en appelant ARSession.Install().
L'appareil est compatible avec ARCore et Google Play Services for AR. Les données de profil de l'appareil ARCore sont installées et à jour. Crée un Session ARCore et commence à utiliser ARCore.

Vous pouvez également consulter ARSession.state pour connaître l'état d'installation et d'assistance.

Respecter les exigences de confidentialité des utilisateurs

Pour publier votre application sur le Play Store, assurez-vous qu'elle respecte les Exigences concernant la confidentialité des utilisateurs d'ARCore.

Et ensuite ?