Connectez-vous avec vos identifiants de compte de développeur·se Meta via l’application.
Appairez votre casque avec l’application.
Mettez votre casque et suivez les instructions du casque pour terminer la configuration.
Pour obtenir des instructions détaillées pour un appareil Quest spécifique, consultez les guides de configuration Premiers pas.
Activation du mode développeur·se
Avant d’activer le mode développeur·se, vérifiez que les conditions suivantes sont remplies :
Vous êtes inscrit·e en tant que développeur·se Meta avec un compte Meta vérifié. Pour vérifier le statut de votre compte, consultez la section Vérification du tableau de bord développeur·se.
Avoir au moins 18 ans.
Votre casque n’a aucune restriction au niveau de l’appareil qui empêche l’activation du mode développeur·se.
Pour activer le mode développeur·se, procédez comme suit :
Sur votre appareil mobile, ouvrez l’application Meta Horizon.
Dans l’application, appuyez sur l’icône du casque dans la barre d’outils.
Votre casque appairé devrait apparaître en haut de l’écran. Appuyez sur l’élément casque, qui affiche le modèle et le statut de votre casque appairé.
Appuyez sur Paramètres du casque en dessous de l’image de votre casque.
Appuyez sur Mode développeur·se.
Activez le mode développeur·se .
Connectez le casque à votre ordinateur à l’aide d’un câble de données USB-C.
Remarque : pour une configuration sans ordinateur, consultez la documentation de configuration de votre appareil dans les pages d’aide Meta Quest.
Mettez le casque.
Dans le casque, ouvrez l’élément du menu Commande rapide.
Sélectionnez Ouvrir les paramètres, représenté par une icône en forme d’engrenage. Ensuite, ouvrez l’onglet Développeur·se et activez Notification MTP.
Lorsque le système vous demande d’autoriser le débogage USB, sélectionnez Toujours autoriser depuis cet ordinateur.
Le Mode développeur·se est réservé aux tâches de développement, telles que l’exécution, le débogage et le test d’applications. Toute autre activité peut entraîner des restrictions, des suspensions ou des résiliations. Pour plus d’informations, consultez les règles relatives au contenu.
Sous Plateformes, sélectionnez Meta Quest, puis cliquez sur Activer la plateforme. Si le profil est déjà installé, cliquez sur Changer de plateforme.
Unity versions prior to 6.1
Si la plateforme Meta Quest est absente de votre version de Unity, sélectionnez la plateforme de compilation Android.
Dans la liste Appareil exécuté, sélectionnez le casque Meta. Si vous ne voyez pas le casque Meta dans la liste, sélectionnez Refresh (Actualiser).
Sélectionnez Build And Run (Développer et exécuter), indiquez un nom et un emplacement pour le fichier .apk (exécutable sur Android) à générer, puis sélectionnez Save (Enregistrer) pour créer l’application et l’exécuter sur votre casque.
Si l’application fonctionne correctement sur le casque, vous avez correctement connecté votre appareil.
Après avoir vérifié que votre appareil est connecté, configurez les outils suivants pour faciliter la connexion, le test et le débogage de votre appareil :
Android Debug Bridge (ADB) est un outil de ligne de commande inclus dans le SDK Android. Vous pouvez utiliser l’outil ADB pour installer des applications et lancer d’autres commandes utiles depuis l’ordinateur.
Link est un outil de développement qui vous permet de streamer des applications depuis votre machine de développement vers un casque Meta Quest. Avec Link, vous pouvez réduire considérablement le temps de développement des applications XR en lançant votre application sur votre casque directement à partir de la vue Scene de l’éditeur Unity, sans avoir besoin de créer et de déployer l’application pour une plateforme Android.
Remarque : actuellement, Link est pris en charge uniquement sous Windows. Si vous développez sous macOS ou si vous n’avez pas accès à un casque, utilisez le Simulateur Meta XR.
Activer Android Debug Bridge
Android Debug Bridge (ADB) est un utilitaire de ligne de commande qui vous permet d’effectuer un certain nombre d’actions utiles au cours du développement XR. On peut citer parmi celles-ci :
L’installation d’applications sur votre casque
Le débogage d’applications sur votre casque
La copie de fichiers sur votre casque
ADB est inclus dans l’installation des outils SDK Android, et il se trouve dans le dossier /Android/SDK/platform-tools/.
Windows : téléchargez le pilote USB OEM, extrayez le fichier ZIP oculus-adb-driver-2.0, accédez au dossier /oculus-go-adb-driver-2.0/usb_driver/, faites un clic droit sur le fichier android_winusb.inf, puis sélectionnez Installer.
macOS : passez à l’étape 3 étant donné que vous n’avez pas besoin de pilotes USB supplémentaires.
Ajoutez le répertoire d’installation au chemin d’accès de votre système.
Windows : si vous utilisez le SDK Android installé avec Unity, le chemin d’installation doit ressembler à ce qui suit :
open la ligne de commande sur votre machine de développement et exécutez la commande suivante pour vérifier l’appareil connecté :
adb devices
Vous devriez voir des résultats semblables à ceux qui suivent :
List of devices attached
1PASH9BB939351 device
Installer une application avec ADB
Après avoir vérifié que votre appareil est connecté, vous pouvez utiliser ADB pour installer un APK directement sur votre casque.
Créez votre projet pour générer un fichier .apk.
Installez l’APK sur votre casque.
Exécutez la commande suivante pour installer un APK sur votre casque :
adb install <APK_PATH>
Par exemple, sur Windows :
adb install C:\Dev\Android\MyProject\VrApp.apk
Sur macOS :
adb install ~/Dev/Android/MyProject/VrApp.apk
Utilisez l’option -r pour écraser tout APK du même nom déjà installé sur l’appareil cible :
adb install -r <APK_PATH>
Remarque : l’installation d’applications avec adb install contourne la méthode d’installation normale de Quest. Les applications installées de cette façon ne seront pas enregistrées et aucune sauvegarde dans le cloud ne sera réalisée.
Pour en savoir plus sur l’utilisation d’ADB avec les appareils Meta Quest, y compris les connexions Wi-Fi, les commandes supplémentaires et le dépannage, consultez l’article Android Debug Bridge pour Meta Quest.
Pour obtenir des informations plus détaillées sur l’utilisation d’ADB, consultez l’article Android Debug Bridge dans la documentation officielle Android.
Configurer Link
Remarque : actuellement, seul Windows prend en charge Link. Si vous développez sous macOS ou si vous n’avez pas accès à un casque, utilisez le Simulateur Meta XR.
Pour en ajouter un à votre scène, procédez comme suit :
La plateforme de développement Meta Quest (MQDH) est une application pour Windows et MacOS qui permet aux développeur·ses de gérer leurs appareils, de débuguer leurs applications et d’envoyer leurs applications au Store.
Téléchargez et installez l’application macOS ou Windows de la Plateforme de développement Meta Quest.
Ouvrez l’application et connectez-vous en utilisant vos identifiants de développeur·se Meta.
Dans le panneau de navigation de gauche, choisissez Device Manager (Gestionnaire d’appareils). Tous les appareils que vous avez configurés s’affichent dans le panneau principal avec leur statut, qui inclut l’ID de l’appareil et l’état de la connexion. Un marqueur vert indique l’appareil Actif.