Résumé
XREAL One Pro n'exécute pas lui-même l'application personnalisée. L'application est créée dans Unity sur un ordinateur, installée sous forme d'APK Android sur XREAL Beam Pro ou sur un autre appareil hôte Android compatible, puis affichée via les lunettes One Pro. Ce modèle d'appareil hôte est le point essentiel que les développeurs doivent comprendre avant de commencer.
La configuration suit un flux de travail clair : préparer Beam Pro, installer Unity et la prise en charge d'Android, ajouter le XREAL SDK, ouvrir et tester l'exemple HelloMR, générer l'APK, l'installer sur Beam Pro avec ADB, connecter le One Pro et lancer l'application via MyGlasses. Pour les entreprises, cette architecture facilite le développement et le test de flux de travail XREAL personnalisés à l'aide d'outils Android et Unity familiers, tout en conservant la logique applicative sur un appareil hôte distinct qui peut être géré, mis à jour et intégré aux systèmes existants de l'entreprise.
L'erreur à éviter : ne planifiez pas un projet dans lequel l'APK est installé directement sur [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro). L'APK s'installe sur l'appareil hôte Android.
Qu'est-ce que XREAL One Pro ?
XREAL One Pro est un écran AR filaire doté d'un champ de vision de 57 degrés, d'écrans Micro-OLED Sony et de la puce de traitement spatial X1 de XREAL. La puce X1 assure un suivi 3DoF natif, de sorte que l'écran reste en place lorsque vous tournez la tête, et depuis le SDK 3.1.0, la série One prend également en charge le suivi de la tête en 6DoF avec la caméra optionnelle XREAL Eye, après une mise à jour du firmware. Rien de tout cela ne fait des lunettes un ordinateur Android autonome.
Pour le développement personnalisé avec le XREAL SDK, c'est l'hôte Android connecté qui gère l'application. Le One Pro est l'écran portable et le point de terminaison du suivi.
Ce dont vous avez besoin pour ce guide
· Un ordinateur Windows ou macOS.
· XREAL Beam Pro, ou un smartphone haut de gamme Samsung testé par XREAL : le Galaxy S24 sous Android 14 ou le Galaxy S25 sous Android 15. XREAL ne prend en charge que les modèles phares de Samsung et demande aux développeurs de ne pas utiliser de téléphones mis à jour vers Android 16 tant que son avis de compatibilité reste en vigueur. Beam Pro est l'hôte utilisé dans les étapes principales.
· Un câble USB-C pour connecter le One Pro au Beam Pro.
· Unity Hub et une version LTS d'Unity compatible avec Android Build Support. (Instructions dans l'article)
· La version actuelle du XREAL SDK pour Unity, disponible sur la page de téléchargement développeurs de XREAL. (Instructions dans l'article)
· Android Debug Bridge (ADB) pour installer l'APK sur Beam Pro. (Instructions dans l'article)
Comment développer votre première application XREAL One Pro
Étape 1 : préparer Beam Pro, l'appareil qui exécutera l'application
Commencez par Beam Pro, car c'est là que l'application Android finale sera installée. Beam Pro est un appareil portable physique, pas un logiciel à télécharger.
1. Procurez-vous XREAL Beam Pro. Achetez le matériel Beam Pro auprès de XREAL ou d'un revendeur agréé. Il est vendu séparément des lunettes One Pro.
2. Allumez-le et connectez-le au Wi-Fi. Effectuez la configuration initiale habituelle d'Android/nebulaOS sur Beam Pro.
3. Ouvrez MyGlasses sur Beam Pro. MyGlasses est l'application de gestion des lunettes XREAL utilisée sur Beam Pro.
4. Mettez à jour Beam Pro et MyGlasses si vous y êtes invité. Le SDK 3.1.0 va de pair avec MyGlasses 1.11.0. La note de version de XREAL indique de mettre d'abord MyGlasses à jour, puis de connecter les lunettes, ce qui déclenche automatiquement la mise à jour de leur firmware. Beam Pro fonctionne sous nebulaOS basé sur Android 14 ; l'avertissement de XREAL concernant Android 16 s'applique donc aux téléphones, pas à Beam Pro.
5. Connectez une première fois le One Pro au Beam Pro. Utilisez le câble USB-C des lunettes. Si une mise à jour du firmware des lunettes s'affiche, effectuez-la avant de commencer le développement.
****
Étape 2 : installer Unity Hub sur l'ordinateur de développement
1. Ouvrez le site web d'Unity sur l'ordinateur. Téléchargez Unity Hub pour Windows ou macOS.
2. Installez et ouvrez Unity Hub. Unity Hub est un programme de bureau distinct qui sert à installer Unity Editor.
3. Connectez-vous ou créez un compte Unity si on vous le demande. Cela permet à Unity Hub d'accéder à l'installation de l'éditeur et à la procédure de licence
Étape 3 : installer une version d'Unity Editor avec la prise en charge d'Android
Le XREAL SDK fonctionne dans Unity : Unity Editor doit donc être installé avant de pouvoir importer le SDK.
1. Ouvrez Unity Hub > Installs. Sélectionnez Install Editor.
2. Choisissez une version LTS compatible. XREAL prend en charge Unity 2021.3.X, 2022.3.X et 6000.0.X LTS. Utilisez une version compatible figurant dans la documentation XREAL actuelle.
3. Sélectionnez Android Build Support. XREAL exige au minimum le niveau d'API 31 du SDK Android (Android 12) ou ultérieur, ce que couvre le SDK fourni.
4. Terminez l'installation. Attendez qu'Unity Hub affiche l'éditeur sous Installs.
Passez à l'étape 4 lorsque : Unity Editor est installé et Android Build Support est inclus.
Étape 4 : télécharger le XREAL SDK sur l'ordinateur
Le XREAL SDK est un fichier qui sera importé ultérieurement dans Unity. N'essayez pas de l'installer sur Beam Pro ni sur les lunettes.
1. Ouvrez la page XREAL Developer Download. Sur l'ordinateur de développement, rendez-vous sur developer.xreal.com/download.
2. Trouvez XREAL SDK for Unity. Acceptez les conditions de l'API XREAL et téléchargez le SDK actuel.
3. Conservez le fichier téléchargé. Le paquet est fourni sous forme de fichier, par exemple com.xreal.xr.tar.gz.
Passez à l'étape 5 lorsque : le fichier du XREAL SDK est enregistré sur l'ordinateur. N'ouvrez pas manuellement le fichier tar.gz.
Étape 5 : créer le projet Unity
Utilisez maintenant Unity Hub pour créer le projet qui deviendra ensuite l'application Android installée sur Beam Pro.
1. Ouvrez Unity Hub > Projects. Sélectionnez New project.
2. Choisissez un modèle 3D standard. Donnez au projet un nom simple, par exemple XREAL-One-Pro-Test, et choisissez l'emplacement où l'enregistrer.
3. Créez le projet. Attendez l'ouverture d'Unity Editor.
4. Basculez le projet vers Android. Dans Unity Editor, ouvrez File > Build Settings. Sélectionnez Android et cliquez sur Switch Platform. Dans Unity 6, utilisez File > Build Profiles si c'est le menu affiché.
Passez à l'étape 6 lorsque : Android est la plateforme de build active dans Unity.
Étape 6 : installer le paquet Unity dont XREAL a besoin
Restez dans Unity Editor. Les outils suivants sont ajoutés à ce même projet.
1. Ouvrez Window > Package Manager. Dans la fenêtre Package Manager, définissez la source des paquets sur Unity Registry. Les paquets fournis par Unity s'affichent alors.
2. Trouvez XR Interaction Toolkit. Sélectionnez-le et cliquez sur Install. XREAL indique que les versions 2.5.x et 3.0.x sont prises en charge ; si le Package Manager installe une version plus récente et que l'exemple ne fonctionne pas correctement, choisissez plutôt la 3.0.x dans la liste des versions.
3. Ouvrez son onglet Samples. Trouvez Starter Assets et cliquez sur Import, puis importez également Hands Interaction Demo. Selon la page de dépannage de XREAL, HelloMR affiche des prefabs manquants sans celui-ci.
Étape 7 : importer le XREAL SDK dans le même projet Unity
Vous êtes toujours dans Unity. Utilisez maintenant le fichier du XREAL SDK téléchargé à l'étape 4.
1. Restez dans Window > Package Manager. Cliquez sur le bouton + en haut à gauche. Sélectionnez ensuite : « Add package from tarball ».
2. Retrouvez le fichier du XREAL SDK téléchargé précédemment. Accédez à votre dossier Téléchargements, sélectionnez le fichier nommé par exemple com.xreal.xr.tar.gz, puis cliquez sur Ouvrir. Unity ajoute alors le XREAL XR Plugin à votre projet.
3. Ouvrez XREAL XR Plugin dans Package Manager > Samples. Importez Interaction Basics. Cela ajoute la scène d'exemple prête à l'emploi HelloMR qui vous servira à vérifier que la configuration XREAL fonctionne.
Étape 8 : activer XREAL dans le projet
Le SDK est présent, mais Unity doit encore savoir que ce projet Android doit utiliser le plug-in XREAL.
1. Ouvrez Edit > Project Settings > XR Plug-in Management. Sélectionnez l'onglet Android.
2. Cochez XREAL. Cela active le fournisseur XR XREAL pour le build Android.
3. Ouvrez Project Validation. Cliquez sur Fix All pour appliquer les modifications XREAL requises.
4. Ouvrez XR Plug-in Management > XREAL. Pour un One Pro sans XREAL Eye, réglez Initial Tracking Type sur MODE_3DOF, Initial Input Source sur Controller (Beam Pro ou le téléphone fait office de manette 3DoF) et Support Devices sur XREAL_DEVICE_CATEGORY_VISION, la catégorie XREAL des lunettes 3DoF comme la série One. Laissez tous les autres paramètres par défaut jusqu'à ce que l'exemple fonctionne.
Passez à l'étape 9 lorsque : Project Validation n'affiche plus aucun paramètre XREAL requis non résolu.
Étape 9 : ouvrir l'exemple HelloMR de XREAL
Avant d'écrire votre propre application, utilisez l'exemple de XREAL. Il permet de confirmer qu'Unity, le XREAL SDK, Beam Pro et les lunettes fonctionnent bien ensemble.
1. Ouvrez le panneau Project dans Unity. Accédez à Assets > Samples > XREAL XR Plugin > [votre version du SDK] > Interaction Basics.
2. Trouvez HelloMR.unity. Double-cliquez sur la scène pour l'ouvrir.
3. Ne la personnalisez pas encore. Générez d'abord l'exemple sans modification afin de vous assurer que l'environnement de développement fonctionne.
Étape 10 : générer l'APK Android sur l'ordinateur
Unity transforme maintenant le projet HelloMR en fichier d'application Android. Ce fichier s'appelle un APK.
1. Ouvrez File > Build Settings ou Build Profiles. Sélectionnez Add Open Scenes pour inclure HelloMR.
2. Vérifiez qu'Android est actif. Si ce n'est pas le cas, basculez vers Android.
3. Cliquez sur Build. Configurez les Player Settings, puis lancez le build. Dans Player Settings, renseignez Company Name et Product Name (MyGlasses affiche le Product Name, utilisez donc XREAL-HelloMR) et vérifiez que Scripting Backend est réglé sur IL2CPP avec ARM64 comme architecture cible ; XREAL exige les deux. Cliquez ensuite sur Build, choisissez un dossier sur votre ordinateur et enregistrez le fichier sous le nom XREAL-HelloMR.apk
4. Attendez la fin du build. L'APK se trouve maintenant sur l'ordinateur, mais pas encore sur Beam Pro.
Ce qu'est un APK : un APK est le fichier utilisé pour installer une application Android. Dans ce flux de travail, l'APK va sur Beam Pro, pas sur [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro).
Étape 11 : installer l'APK sur Beam Pro
ADB : Android Debug Bridge, un outil informatique utilisé pour installer et tester des applications Android sur Beam Pro ou sur un téléphone.
L'application est générée. L'étape suivante consiste à transférer cet APK de l'ordinateur vers Beam Pro.
1. Connectez Beam Pro à l'ordinateur en USB-C.
2. Ouvrez Terminal ou PowerShell sur l'ordinateur.
3. Activez le débogage USB sur Beam Pro. Le guide de XREAL indique seulement d'activer les options pour les développeurs et le débogage USB sur l'hôte ; sur Android, cela consiste à appuyer sept fois sur « Numéro de build » sous « À propos » pour déverrouiller les options pour les développeurs, puis à y activer le débogage USB. Si Beam Pro affiche un message demandant s'il faut autoriser le débogage USB depuis cet ordinateur, sélectionnez Autoriser.
4. Vérifiez que l'ordinateur détecte Beam Pro. Dans PowerShell, tapez :
adb devices
Si Beam Pro apparaît comme device, la connexion fonctionne et vous pouvez continuer.
5. Installez l'APK. Commencez par localiser le fichier XREAL-HelloMR.apk sur votre ordinateur. Par exemple, si vous l'avez enregistré dans un dossier nommé XREAL Test sur votre Bureau, le chemin Windows pourrait ressembler à ceci :
C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk
Dans PowerShell, tapez :
adb install -r "C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk"
Remplacez le chemin d'exemple par l'emplacement réel de votre APK, puis appuyez sur Entrée.
6. Attendez le message Success. Lorsque ADB affiche Success, l'application est installée sur Beam Pro.
Passez à l'étape 12 lorsque : l'installation de l'APK affiche Success sur l'ordinateur.
Étape 12 : connecter le One Pro au Beam Pro et ouvrir l'application
L'application Android se trouve maintenant sur Beam Pro. C'est seulement à ce moment-là que vous déplacez la connexion USB-C de l'ordinateur vers les lunettes.
1. Déconnectez Beam Pro de l'ordinateur.
2. Connectez [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) au Beam Pro. Utilisez le câble USB-C XREAL.
3. Ouvrez MyGlasses sur Beam Pro. Il s'agit de l'environnement XREAL utilisé pour gérer les lunettes connectées et lancer les applications 3D XREAL.
4. Trouvez votre application dans MyGlasses. Elle apparaît sous le Product Name défini dans Player Settings, et non sous le nom du fichier APK. Sélectionnez-la et ouvrez-la. Si elle n'apparaît pas, ou si MyGlasses indique que l'application n'est pas prise en charge sur cet appareil, appuyez dix fois sur l'icône des lunettes en haut à gauche de MyGlasses, lunettes déconnectées, pour ouvrir le mode développeur, puis utilisez « select other MR App » pour la sélectionner.
5. Accordez les autorisations si on vous le demande.
6. Regardez à travers le One Pro. La scène HelloMR devrait maintenant apparaître dans les lunettes pendant que Beam Pro exécute l'application.
Étape 13 : apporter une première petite modification personnalisée
Une fois que l'exemple HelloMR non modifié fonctionne, revenez à Unity et modifiez un seul élément. Vous évitez ainsi de déboguer votre propre code avant d'avoir validé la configuration XREAL de base.
1. Revenez à Unity sur l'ordinateur. Ouvrez la scène HelloMR. Ouvrez l'onglet Scene. C'est là que vous pouvez construire l'interface et positionner les objets qui apparaîtront à travers le XREAL One Pro.
2. Ajoutez un Cube. Choisissez GameObject > 3D Object > Cube et placez-le à environ un mètre devant la caméra. Le texte, les boutons, les panneaux et les modèles importés s'ajoutent ensuite de la même manière. (HelloMR ne contient pas de Cube ; l'exemple de XREAL affiche son objet logo, le Cube des points 6 et 7 doit donc être créé ici.)
3. Sélectionnez un objet dans la Hierarchy. Utilisez l'Inspector pour modifier sa position, sa taille, sa rotation et d'autres paramètres.
4. Organisez la mise en page de l'application. Construisez l'interface nécessaire au projet, par exemple des instructions, un modèle de produit, un panneau d'état ou un bouton « Démarrer l'inspection ».
5. N'ajoutez du code C# que lorsqu'un comportement personnalisé est nécessaire. Le code n'est pas nécessaire pour simplement placer et concevoir des objets. Créez un script sous Assets > Scripts uniquement lorsqu'un objet doit se déplacer, réagir à une entrée, modifier des informations ou se connecter à des données externes.
Par exemple, ce script facultatif fait pivoter un objet :
using UnityEngine;
public class SpinObject : MonoBehaviour
{
public float speed = 30f;
void Update()
{
transform.Rotate(0f, speed * Time.deltaTime, 0f);
}
}
6. Associez le script au Cube. Faites glisser SpinObject depuis Assets > Scripts sur le Cube dans la Hierarchy.
7. Générez et installez à nouveau. Répétez les étapes 10 à 12. Le Cube devrait tourner lorsque l'application s'exécute sur Beam Pro et s'affiche via le One Pro.
Ce que cela démontre : votre code C# personnalisé est exécuté par l'application Android sur Beam Pro. Les lunettes affichent le résultat.
Si vous souhaitez utiliser un téléphone Android au lieu de Beam Pro
La même architecture générale s'applique, mais l'hôte devient un téléphone Android compatible. Vous n'utilisez pas MyGlasses dans ce cas.
· Utilisez un téléphone approuvé par XREAL. Le SDK 3.1.0 mentionne le Samsung Galaxy S25 sous Android 15 ; la page de compatibilité de XREAL mentionne également le Galaxy S24 sous Android 14 et précise que seuls les modèles phares de Samsung sont pris en charge. Vérifiez la version Android du téléphone avant d'acheter ou de mettre à jour : XREAL demande aux développeurs de ne pas passer leurs appareils de développement à Android 16, or Samsung déploie Android 16 (One UI 8) sur les deux modèles depuis septembre 2025. Désactivez Samsung DeX pendant le développement.
· Installez l'APK sur le téléphone plutôt que sur Beam Pro.
· Connectez XREAL One Pro au téléphone en USB-C.
· Ouvrez ControlGlasses, trouvez l'application XREAL installée et lancez-la.
Ne mélangez pas les deux méthodes : Beam Pro utilise MyGlasses. Un téléphone Android compatible utilise ControlGlasses.
Erreurs de développement courantes
- Essayer d'installer l'APK sur les lunettes : installez-le sur Beam Pro ou sur le téléphone Android compatible.
- Penser que Beam Pro est une application : Beam Pro est un matériel physique distinct. MyGlasses est l'application XREAL utilisée sur Beam Pro.
- Utiliser MyGlasses sur un téléphone Android ordinaire : le développement sur téléphone utilise plutôt ControlGlasses.
- Commencer par du code personnalisé avant que HelloMR fonctionne : exécutez d'abord l'exemple non modifié, puis personnalisez-le.
- Laisser Beam Pro connecté à l'ordinateur en essayant d'utiliser les lunettes : après avoir installé l'APK, déconnectez Beam Pro de l'ordinateur et connectez le One Pro au Beam Pro.
Conclusion
Le développement pour XREAL One Pro commence par la distinction des trois composantes du système : l'ordinateur est l'endroit où le projet Unity est créé, Beam Pro ou un téléphone Android compatible est l'endroit où l'APK Android s'exécute réellement, et XREAL One Pro est l'écran portable et le dispositif de suivi. En prenant Beam Pro comme voie la plus claire, configurez d'abord le Beam Pro physique, installez Unity Hub et une version compatible d'Unity Editor sur l'ordinateur, téléchargez et importez le XREAL SDK, activez le plug-in XREAL, ouvrez l'exemple HelloMR, générez un APK, installez cet APK sur Beam Pro avec ADB, puis déconnectez Beam Pro de l'ordinateur, connectez le One Pro et lancez l'application via MyGlasses. Pour les entreprises, comprendre cette architecture avant de commencer le développement aide à définir le bon plan en matière de matériel, de sécurité et de déploiement, facilite le dépannage des projets pilotes et évite que les équipes perdent du temps à développer pour un modèle de lunettes autonomes que le One Pro n'utilise pas.
Vous prévoyez une application XREAL One Pro ? Commencez avec un Beam Pro, un One Pro et l'exemple HelloMR, validez d'abord le flux de travail entre l'hôte et les lunettes, puis n'ajoutez que les fonctionnalités Unity nécessaires au cas d'usage de l'entreprise.
























