Guide : activer le mode développeur & connecter votre casque (USB, puis Wi-Fi)

Prérequis

• Un PC (Windows, macOS ou Linux) avec le SDK Platform Tools (adb) installé. Téléchargement officiel : Android Platform Tools.
• Drivers USB/ADB : sur Windows 10/11 récents, les drivers génériques suffisent souvent. Si adb devices reste vide, installez le driver Quest (app Meta Quest PC) ou le Google USB Driver, puis forcez WinUSB pour le casque dans le Gestionnaire de périphériques.
• Le casque VR (Meta Quest / Pico / autre casque Android) et le câble USB pour le connecter au PC.
• L'application mobile ou le compte développeur (pour certains casques comme Meta Quest, il faut créer une organisation sur developer.oculus.com et activer le mode développeur dans l'app mobile).
• Le fichier d'installation (APK) fourni lors du téléchargement de la démo : /vhr-dashboard-demo.apk.

Étapes détaillées

1. Installer adb sur votre PC

   Décompressez platform-tools, puis vérifiez que adb est accessible dans votre terminal / PowerShell :

   adb version
   adb devices

   Si vous êtes sous Windows, utilisez PowerShell pour exécuter ces commandes. Ajoutez platform-tools à votre PATH pour ne pas taper le chemin complet.

2. Activer le mode développeur sur le casque

   Ouvrez l'application mobile du fabricant (ex. : application Meta/Oculus), sélectionnez votre casque, puis activez Developer Mode (Mode développeur). Cette opération nécessite un compte développeur/organisation pour certains casques.

   Note : les menus peuvent varier selon le modèle (Quest, Pico...). Consultez la documentation fabricant si besoin.

3. Première connexion : brancher le casque en USB

   Branchez le casque en USB à votre PC. Depuis votre terminal :

   adb devices

   Une popup apparaitra dans le casque demandant d'autoriser le débogage USB. Acceptez la connexion et cochez « Toujours autoriser » si vous faites confiance à ce PC pour éviter les demandes répétées.

4. Installer l'application (démo)

   Si vous avez téléchargé la démo APK, installez-la via adb :

   adb install -r path\to\vhr-dashboard-demo.apk

   Vous pouvez vérifier la présence de l'application avec :

   adb shell pm list packages | findstr VR-Manager

5. Activer ADB over Wi‑Fi (pour sessions sans USB)

   Une fois la connexion USB réussie, vous pouvez passer le casque en mode ADB Wi‑Fi :

   adb tcpip 5555
   # Récupérez l'IP du casque (connecté au même réseau Wi‑Fi que votre PC)
   adb shell ip addr show wlan0
   # ou utilisez la sortie de la commande suivante pour Quest:
   adb shell ip route | awk '{print $9}'
   # puis connectez
   adb connect 192.168.X.Y:5555
   adb devices

   Si la connexion est établie, vous verrez le casque apparaître comme 192.168.x.y:5555 dans la liste adb devices.

6. Déconnecter le câble USB

   Après la connexion Wi‑Fi, vous pouvez débrancher le câble USB et continuer à utiliser adb via Wi‑Fi. Pour revenir au mode USB si nécessaire :

   adb usb

7. Bonne pratique & sécurité

   • Activez le mode développeur uniquement sur des casques de test ou des casques dédiés à la gestion (ne pas activer sur un casque consistentiel pour utilisateurs non-tech).
   • Si vous perdez la connexion Wi‑Fi, branchez à nouveau via USB et vérifiez l'adresse IP.
   • Sur certains réseaux, le pare-feu/routeur bloque la découverte ; assurez-vous que PC et casque sont sur le même réseau et que le Wi‑Fi autorise la communication entre clients.

Utiliser VHR DASHBOARD

Après avoir mis en place ADB via USB ou Wi‑Fi, lancez VHR DASHBOARD sur votre PC et utilisez la fonctionnalité de détection des appareils pour lister et gérer les casques. Pour tout problème de connexion, consultez notre FAQ ou contactez le support via la page Contact.

Télécharger la démo (APK)

Note: l'archive contient un fichier vhr-dashboard-demo.apk placeholder pour les tests. Ce placeholder n'est pas un APK installable ; si vous obtenez INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION, c'est parce que l'APK est invalide. Pour installer depuis ADB :

1. Extrayez la ZIP et vérifiez le fichier APK : adb devices pour confirmer qu'un appareil est connecté.
2. Vérifiez que l'APK est valide avec la commande fournie (Node) : npm run check-apk downloads/vhr-dashboard-demo.apk.
3. Si le check est vert, installez : adb install -r path\\to\\vhr-dashboard-demo.apk.