Tutoriels

Premiers pas avec Unity et Android XR

Temps de lecture : 6 min
Voir le profil de Luke Hopkins
Luke Hopkins Ingénieur des relations avec les développeurs, Android

Le Samsung Galaxy XR est arrivé, avec la technologie Android XR ! Cet article de blog fait partie de notre Semaine Spotlight sur Android XR, au cours de laquelle nous fournissons des ressources (articles de blog, vidéos, exemples de code, etc.) conçues pour vous aider à apprendre, à créer et à préparer vos applications pour Android XR.

C'est le moment idéal pour vous lancer dans le développement XR. En décembre dernier, nous avons annoncé Android XR, la nouvelle plate-forme Android de Google basée sur des standards ouverts tels qu'OpenXR et Vulkan, qui rend le développement XR plus accessible que jamais.


Et lorsqu'il est combiné aux outils XR existants d'Unity, vous obtenez une pile de développement puissante et mature. Cela permet de créer et de déployer des applications XR qui fonctionnent sur plusieurs appareils.

openxr_face_tracking2.webp

Que vous ayez déjà développé pour la XR ou non, nous voulons vous aider à vous lancer.

Cet article de blog vous aidera à vous familiariser avec le développement pour Android XR et Unity. Nous allons nous concentrer sur les étapes pratiques pour configurer votre environnement, comprendre l'écosystème de packages et commencer à créer.

À la fin de cet article, vous aurez une bonne compréhension des points suivants :

  • L'écosystème de packages
  • Étapes de configuration essentielles
  • Modes de saisie
  • Confidentialité et autorisations
  • Couches de composition

Développement Unity pour Android XR

Vous pouvez choisir Unity pour sa compatibilité multiplate-forme, qui vous permet de créer une seule fois et de déployer sur Android XR et d'autres appareils XR.

Lorsque vous utilisez Unity, vous bénéficiez de son écosystème et de ses outils XR matures. Il dispose déjà de packages établis tels que XR Interaction Toolkit, le plug-in OpenXR, les calques de composition XR, XR Hands, un vaste magasin d'assets rempli de composants et de modèles compatibles avec la XR, ainsi que des outils de simulation et de test XR. Depuis la sortie d'Unity 6 en novembre dernier, vous bénéficiez également de performances améliorées pour le pipeline de rendu universel (URP), d'une meilleure compatibilité avec les graphismes Vulkan et de profils de compilation améliorés.

Voici quelques exemples de projets pour vous donner une idée de ce qu'il est possible de faire :

Configuration essentielle : les bases de votre développement

Conditions requises et installation d'Unity 6

Vous aurez besoin d'Unity 6 pour créer votre application, car les versions antérieures ne sont pas compatibles avec Android XR. Installez d'abord Unity Hub, puis Unity 6 avec le module Android Build Support, en suivant ces étapes.

unity6.png

Profils de compilation Android XR : simplifier la configuration

Les profils de compilation Unity sont des éléments de projet qui stockent vos paramètres et configurations spécifiques à la plate-forme. Ainsi, au lieu de devoir configurer manuellement 15 à 20 paramètres différents dans plusieurs menus, vous pouvez utiliser un profil de compilation pour le faire automatiquement.
Vous pouvez créer vos propres profils de compilation, mais pour l'instant, nous vous recommandons d'utiliser le profil de compilation Android XR dédié que nous avons créé.

Vous pouvez sélectionner votre profil de compilation en sélectionnant File > Build Profile (Fichier > Profil de compilation) dans votre projet Unity. Pour obtenir des instructions complètes, consultez la page du workflow Développer pour Android XR.

Si vous apportez des modifications, vous pouvez créer un profil de compilation à partager avec votre équipe. Vous garantissez ainsi une expérience de compilation cohérente à tous les niveaux.

buildprofiles.png

Après avoir suivi ces étapes, vous pouvez compiler et exécuter votre APK pour les appareils Android XR.

API graphique : pourquoi Vulkan est important

Une fois que vous avez configuré votre projet Unity avec un profil de compilation Android XR, nous vous recommandons de vous assurer que Vulkan est défini comme API graphique. Android XR est conçu comme une plate-forme axée sur Vulkan. En mars 2025, Google a annoncé que Vulkan est désormais l'API graphique officielle pour Android. Il s'agit d'une API graphique moderne de bas niveau qui aide les développeurs à maximiser les performances des GPU modernes et à débloquer des fonctionnalités avancées telles que le ray tracing et le multithreading pour des visuels de jeu réalistes et immersifs.

Ces normes offrent la meilleure compatibilité pour vos applications existantes, et réduisent les problèmes et les coûts de portage. Il permet également d'activer des fonctionnalités Android XR avancées telles que l'Application SpaceWarp URP et le rendu fovéal. 

Unity 6 gère Vulkan automatiquement. Ainsi, lorsque vous utilisez le profil de compilation Android XR, Unity configure Vulkan comme API graphique. Vous aurez ainsi accès à toutes les fonctionnalités avancées d'Android XR sans aucune configuration manuelle.

Pour vérifier les paramètres de l'API graphique, accédez à Edit > Project Settings > Player > Android tab > Other settings > Graphics APIs (Modifier > Paramètres du projet > Lecteur > Onglet Android > Autres paramètres > API graphiques).

graphics-api.png
appentrypoint.png

Comprendre l'écosystème des packages

Vous pouvez utiliser deux packages différents pour Android XR dans Unity. La première consiste à utiliser les extensions Android XR pour Unity, et la seconde à utiliser le package Unity OpenXR: Android XR.

Ces deux concepts peuvent sembler identiques, mais laissez-moi vous expliquer.

Le package Unity OpenXR: Android XR est le package Unity officiel pour la compatibilité avec Android XR. Il fournit la majorité des fonctionnalités Android XR, disponibles via les normes OpenXR. Il permet également l'intégration d'AR Foundation pour les fonctionnalités de réalité mixte. Le principal avantage du package Unity OpenXR: Android XR est qu'il offre une API unifiée pour la compatibilité avec les appareils XR.


Les extensions Android XR pour Unity sont le package XR de Google, conçu spécifiquement pour le développement sur les appareils Android XR. Il complète le package Unity OpenXR avec des fonctionnalités supplémentaires telles que les modes de fusion de l'environnement, le maillage de scène, le suivi d'images et le suivi corporel. En contrepartie, vous ne pouvez développer que pour les appareils Android XR.


Le choix dépend de vos besoins spécifiques, mais nous vous recommandons généralement d'opter pour Unity OpenXR : Android XR, car il offre une plus grande flexibilité pour les appareils avec lesquels votre application sera compatible. En fonction des exigences de votre application, vous pourrez ensuite ajouter des extensions Android XR pour Unity.

Installer des packages

Pour ajouter un package, ouvrez votre projet dans Unity, puis sélectionnez Window > Package Management > Package Manager (Fenêtre > Gestion des packages > Gestionnaire de packages).

Vous pouvez installer ces packages à partir de l'onglet "Unity Registry" :

packagemanager.png

Vous pouvez installer le package Android XR pour Unity via GitHub en sélectionnant l'icône ➕, puis "Install package from git URL" (Installer le package à partir de l'URL Git), puis en saisissant "https://github.com/android/android-xr-unity-package.git".

packagemanager2.png

Fonctionnalités OpenXR requises

Maintenant que vous avez installé les packages dont vous avez besoin, activons certaines fonctionnalités essentielles pour que notre projet fonctionne.

Vous pouvez activer le paramètre OpenXR pour Android : Edit > Project Settings > XR Plugin Management > cliquez sur Android et activez OpenXR.

xrpluginmgmt.png

Nous devons ensuite activer la compatibilité avec Android XR. Nous aborderons les autres fonctionnalités d'OpenXR au fur et à mesure de nos besoins. Pour l'instant, il nous suffit d'activer la compatibilité avec Android XR.

Entrée

Android XR accepte les entrées par les mains, la voix, le suivi oculaire, le clavier et les manettes. Nous vous recommandons d'installer XR Interaction Toolkit et XR Hands, car ils contiennent les meilleurs prefabs pour commencer. En utilisant ces prefabs, vous disposerez de tout ce dont vous avez besoin pour prendre en charge les mains et les manettes dans votre application.

xrinteractiontoolkit.png

Une fois XR Hands et XR Interaction Toolkit installés, je vous recommande d'importer les assets de démarrage et la démo d'interaction avec les mains. Vous devez ensuite activer les profils Hand Interaction et Khronos Simple Controller, puis activer les fonctionnalités Hand Tracking Subsystem et Meta Hand Tracking Aim.

Pour modifier ces paramètres, accédez à Edit > Project Settings > XR Plug-in Management > OpenXR (Modifier > Paramètres du projet > Gestion des plug-ins XR > OpenXR).

profiles.png

Nous vous recommandons également d'utiliser le préfabriqué Unity XR Origin, qui représente la position et l'orientation de l'utilisateur dans l'espace XR. Il contient les composants de caméra et de suivi nécessaires pour afficher votre expérience XR depuis le bon point de vue.

Le moyen le plus simple d'ajouter ce préfabriqué est de l'importer à partir de la démo d'intégration des mains que nous avons importée précédemment. Elle se trouve ici : "Hands Integration Toolkit" > "Hand Interaction" > "Prefabs" > "XR Origin".

prefabs.png

Nous vous recommandons d'utiliser ce préfabriqué plutôt que l'option "XR Origin" dans vos objets de jeu, car il utilise le gestionnaire de modalité d'entrée XR, qui bascule automatiquement entre les mains et les manettes des utilisateurs. Cela vous permettra de passer plus facilement des mains aux manettes.

Confidentialité et autorisations : gagner la confiance des utilisateurs

Quelle que soit l'application que vous créez, vous devez obtenir des autorisations d'exécution de la part des utilisateurs. En effet, la compréhension de la scène, le suivi oculaire, le suivi du visage et le suivi des mains permettent d'accéder à des données qui peuvent être plus sensibles pour l'utilisateur.

Ces fonctionnalités fournissent des informations personnelles plus détaillées que les applications de bureau ou mobiles traditionnelles. Les autorisations d'exécution permettent donc aux utilisateurs de contrôler pleinement les données qu'ils choisissent de partager. Pour respecter les règles de sécurité et de confidentialité d'Android, Android XR dispose d'autorisations pour chacune de ces fonctionnalités.

Par exemple, si vous utilisez le package XR Hands pour les gestes de la main personnalisés, vous devez demander l'autorisation de suivi des mains (voir ci-dessous), car ce package doit suivre de nombreuses informations sur les mains de l'utilisateur. Cela inclut, par exemple, le suivi des poses des articulations de la main, ainsi que des vitesses angulaires et linéaires.

Remarque : Pour obtenir la liste complète des extensions nécessitant des autorisations, consultez les informations sur le site Web des développeurs XR.

const string k_Permission = "android.permission.HAND_TRACKING";

#if UNITY_ANDROID
void Start()
{
    if (!Permission.HasUserAuthorizedPermission(k_Permission))
    {
        var callbacks = new PermissionCallbacks();
        callbacks.PermissionDenied += OnPermissionDenied;
        callbacks.PermissionGranted += OnPermissionGranted;
        
        Permission.RequestUserPermission(k_Permission, callbacks);
    }
}

void OnPermissionDenied(string permission)
{
    // handle denied permission
}


void OnPermissionGranted(string permission)
{
    // handle granted permission
}

#endif // UNITY_ANDROID

Améliorer la qualité visuelle avec des couches de composition

Une couche de composition est la méthode recommandée pour afficher les éléments d'interface utilisateur. Ils permettent d'afficher des éléments avec une qualité bien supérieure à celle du pipeline de rendu standard d'Unity, car tout est directement affiché dans le compositeur de la plate-forme.

Par exemple, si vous affichez du texte, le rendu Unity standard est plus susceptible de présenter du texte flou, des contours adoucis et des artefacts visuels. En revanche, avec les couches de composition, le texte sera plus clair, les contours seront plus nets et l'expérience sera globalement meilleure.


En plus du texte, il affiche également les vidéos, les images et les éléments d'interface utilisateur avec une qualité bien supérieure. Pour ce faire, il utilise la compatibilité native avec les couches du compositeur de l'environnement d'exécution.

Pour activer les couches de composition, ouvrez le gestionnaire de paquets, sélectionnez "Unity Register", puis installez "XR Composition Layers".

Compiler et exécuter

Maintenant que vous avez installé vos packages OpenXR, activé les fonctionnalités et configuré un préfabriqué pour les mouvements de la main et de la tête, vous pouvez créer votre scène et la déployer directement sur votre casque pour la tester.

Étapes suivantes : développer vos compétences

Maintenant que vous avez configuré votre environnement de développement Android XR et que vous comprenez les concepts clés, voici les prochaines étapes pour poursuivre votre parcours de développement XR :

Ressources essentielles pour continuer à apprendre :

Exemples de projets à explorer :

Écrit par :
Continuer la lecture