Activez la RA pour utiliser les fonctionnalités de réalité augmentée dans votre appli (nouvelle ou existante).
Rendre votre application obligatoire ou facultative
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. Vous pouvez configurer une application compatible avec les fonctionnalités de RA de deux manières: RA requise et RA facultative. Cette désignation détermine la manière dont l'application interagit avec les services Google Play pour l'application de RA.
Une application requise pour la RA 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.
- Le Google Play Store ne proposera les applications requises pour la RA 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 sont obsolètes ou ont été désinstallés manuellement.
Une application AR Optional utilise ARCore pour améliorer les fonctionnalités existantes. Il comporte 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 : des applications facultatives 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.
| Demande de récupération de compte | RA facultatif | |
|---|---|---|
| Utilisation des fonctionnalités de RA | Votre application a besoin d'ARCore pour ses fonctionnalités de base. | ARCore améliore les fonctionnalités de votre application. Votre application peut s'exécuter sans prise en charge d'ARCore. |
| Visibilité sur le Play Store | Votre application n'est disponible sur le Play Store que sur les appareils compatibles avec ARCore. | Votre application respecte les procédures de référencement normales. |
| Services Google Play pour la méthode d'installation de 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 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é d'ARCore et l'état de l'installation
|
||
Doit utiliser
la coroutine ARSession.Install() ;
pour installer les services Google Play pour la RA |
Rendre votre application obligatoire pour la récupération des comptes
Android
Accédez à Edit > Project Settings > XR Plug-in Management > ARCore. Requirement est défini sur Required par défaut.
Cliquez sur Edit > Project Settings > Player, puis sélectionnez l'onglet contenant l'icône .
Sous Other Settings > Identification, spécifiez une Minimum API Level égale ou supérieure à
24.
iOS
Accédez à Edit > Project Settings > XR Plug-in Management > ARKit. Requirement est défini sur Required par défaut.
Cliquez sur Edit > Project Settings > Player, puis sélectionnez l'onglet contenant le menu .
Sous Other Settings > Configuration, spécifiez la Target minimum iOS Version pour votre application.
Rendre votre application facultative en RA
Android
Accédez à Edit > Project Settings > XR Plug-in Management > ARCore.
Dans le menu déroulant Requirement, sélectionnez Optional. pour activer le mode RA (facultatif).
Cliquez sur Edit > Project Settings > Player, puis sélectionnez l'onglet contenant l'icône .
Sous Other Settings > Identification, spécifiez une Minimum API Level égale ou supérieure à
24.
iOS
Accédez à Edit > Project Settings > XR Plug-in Management > ARKit.
Dans le menu déroulant Requirement, sélectionnez Optional. pour configurer votre application en RA (facultatif).
Cliquez sur Edit > Project Settings > Player, puis sélectionnez l'onglet contenant le menu .
Sous Other Settings > Configuration, spécifiez la Target minimum iOS Version pour votre application.
Effectuer des vérifications d'exécution
Vérifier si les Services Google Play pour la RA sont installés
RA requise et RA en option Les applications facultatives 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 (toujours) installée et pour vous assurer que toutes les données de profil d'appareil ARCore requises ont été téléchargées.
Pendant l'exécution, les applications requises pour la RA effectuent automatiquement des vérifications à l'exécution pour assurez-vous que l'appareil cible:
- Compatible avec ARCore
- A installé Google Play Services for AR, si ce n'est pas le cas (peut-être parce que l'utilisateur l'a supprimé) ou que la version est trop ancienne, votre l'application invite l'utilisateur à l'installer ou à la mettre à jour.
- Dispose de données de profil ARCore à jour sur l'appareil. Si elles sont obsolètes, votre application télécharge les nouvelles données.
Définissez ARSession.attemptUpdate sur false pour désactiver ces vérifications par défaut. Votre application
doit quand même gérer ces conditions:
| Condition | Action |
|---|---|
| L'appareil n'est pas compatible avec ARCore. | Masque les fonctionnalités de RA. |
| L'appareil est compatible avec ARCore, mais Google Play Services for AR et/ou Les données de profil de l'appareil ARCore ne sont pas installées ou sont 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, Google Play Services for AR et 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 les états d'installation et d'assistance dans ARSession.state.
Respecter les exigences de confidentialité des utilisateurs
Pour publier votre application sur le Play Store, assurez-vous qu'elle est conforme aux Exigences concernant la confidentialité des utilisateurs.
Étapes suivantes
- Découvrez comment configurer une session ARCore.