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 qu'elle soit obligatoire ou facultative.

Pour économiser de l'espace sur chaque appareil, 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 RA requise ne peut pas fonctionner sans ARCore. Elle nécessite un appareil compatible ARCore sur lequel les services Google Play pour la RA sont installés.

  • Sur le Google Play Store, seules les applications compatibles avec la RA requise seront disponibles 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 seraient obsolètes ou aient été désinstallés manuellement.

Une application facultative utilise ARCore pour améliorer les fonctionnalités existantes. Elle propose 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.

  • RA : les applications facultatives peuvent être installées et exécutées sur des appareils non compatibles avec ARCore.
  • Lorsque les utilisateurs installent une application facultative de RA, le Google Play Store n'installe pas automatiquement les Services Google Play pour la RA sur l'appareil.
RA requiseRA (facultatif)
Utilisation de la fonctionnalité RA Votre application nécessite ARCore pour les fonctionnalités de base. ARCore améliore les fonctionnalités de votre application. Votre application peut s'exécuter sans la 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 standards pour diffuser les 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 la coroutine ARSession.Install() 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 n'importe quelle 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
Vous devez utiliser la coroutine ARSession.Install() pour installer les services Google Play pour la RA

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 le Target minimum iOS Version pour votre application.

Rendre la RA de votre application facultative

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 "RA" (facultatif).

  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 le Target minimum iOS Version pour votre application.

Effectuer des vérifications d'exécution

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

Les applications AR Required et AR Optional doivent utiliser la coroutine ARSession.Install() avant de créer une session ARCore pour vérifier si une version compatible des services Google Play pour la RA est installée (toujours) et pour s'assurer que toutes les données de profil d'appareil ARCore requises ont été téléchargées.

Pendant l'exécution, les applications de RA requises 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 cette version n'est pas installée (peut-être parce que l'utilisateur l'a supprimée) ou si la version est trop ancienne, votre application invitera l'utilisateur à l'installer ou à la mettre à jour.
  • Dispose des données de profil d'appareil ARCore à jour. Si elles sont obsolètes, votre application téléchargera de 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 de RA.
L'appareil est compatible avec ARCore, mais les données de profil de l'appareil Google Play Services for AR et/ou ARCore ne sont pas installées ou ne sont pas obsolètes. Invite l'utilisateur à installer ou mettre à jour Google Play Services for AR et/ou les données de profil de l'appareil 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 les états 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 ?