Articles sur : Intégrations
Cet article est aussi disponible en :

Envoyer des données vers OpenTrack

Guide de configuration OpenTrack


Ce guide explique comment configurer OpenTrack pour recevoir les données de suivi de tête depuis PlayAbility.


Qu'est-ce qu'OpenTrack ?


OpenTrack est une application open-source de suivi de tête qui traduit les mouvements de la tête en entrées de jeu. Elle est couramment utilisée avec les simulateurs de vol, les jeux de course et d'autres applications supportant le suivi de tête.


Prérequis


  • PlayAbility installé et en cours d'exécution
  • OpenTrack installé (Télécharger depuis GitHub)
  • Une webcam pour la détection faciale (requise pour que PlayAbility suive votre tête)


Étape 1 : Installer OpenTrack


  1. Téléchargez la dernière version d'OpenTrack depuis GitHub
  2. Extrayez le fichier ZIP dans un dossier (ex : C:\Program Files\opentrack)
  3. Lancez opentrack.exe pour démarrer OpenTrack


Étape 2 : Configurer l'entrée OpenTrack


OpenTrack doit être configuré pour recevoir les données UDP depuis PlayAbility :


  1. Dans OpenTrack, cliquez sur Input (ou appuyez sur F1)
  2. Sélectionnez UDP over network dans le menu déroulant
  3. Cliquez sur Start pour commencer l'écoute des données UDP
  4. Vérifiez les paramètres :
  • Protocol : UDP over network
  • Port : 4242 (par défaut)
  • Bind address : 127.0.0.1 (localhost)


Étape 3 : Configurer la sortie OpenTrack


Configurez OpenTrack pour envoyer les données de suivi à votre jeu ou application :


  1. Dans OpenTrack, cliquez sur Output (ou appuyez sur F2)
  2. Sélectionnez votre méthode de sortie préférée :
  • FreeTrack 2.0 Enhanced - Pour les jeux plus anciens
  • vJoy - Pour les jeux supportant vJoy
  • SimConnect - Pour Microsoft Flight Simulator
  • UDP over network - Pour les applications acceptant l'entrée UDP
  • Wine - Pour la compatibilité Linux
  1. Configurez les paramètres de sortie selon les exigences de votre jeu
  2. Cliquez sur Start pour démarrer la sortie


Étape 4 : Configurer PlayAbility


Activez la sortie OpenTrack dans PlayAbility :


  1. Ouvrez PlayAbility
  2. Naviguez vers Connections dans la barre latérale puis cliquez sur l'onglet OpenTrack
  3. Activez le toggle « Enable OpenTrack Output »
  4. (Optionnel) Activez « Auto-start OpenTrack Output » si vous souhaitez qu'il démarre automatiquement au lancement de PlayAbility


Ce qui se passe quand c'est activé


Lorsque la sortie OpenTrack est activée, PlayAbility va :

  • Activer automatiquement la détection faciale (requise pour le suivi de tête)
  • Commencer à envoyer les données de pose de la tête via UDP vers 127.0.0.1:4242
  • Envoyer les données à environ 30 fps (à chaque nouvelle donnée caméra)


Étape 5 : Vérifier la connexion


Pour vérifier que les données circulent correctement :


  1. Dans OpenTrack : Regardez la fenêtre principale — vous devriez voir l'indicateur de position de la tête bouger quand vous bougez la tête
  2. Dans PlayAbility : Assurez-vous que votre webcam est active et que la détection faciale fonctionne
  3. Test : Bougez votre tête lentement et observez la visualisation OpenTrack répondre


Format des données


PlayAbility envoie les données de suivi de tête dans le format suivant :


  • Protocol : UDP (User Datagram Protocol)
  • Port : 4242
  • Host : 127.0.0.1 (localhost)
  • Format : Binaire (48 octets)
  • 6 nombres flottants en double précision (8 octets chacun, little-endian)
  • Ordre : X, Y, Z, Yaw, Pitch, Roll
  • Les valeurs de translation (X, Y, Z) sont en mètres
  • Les valeurs de rotation (Yaw, Pitch, Roll) sont en degrés


Système de coordonnées


  • X : Translation gauche/droite (mètres)
  • Y : Translation haut/bas (mètres)
  • Z : Translation avant/arrière (mètres)
  • Yaw : Rotation autour de l'axe Y (degrés)
  • Pitch : Rotation autour de l'axe X (degrés)
  • Roll : Rotation autour de l'axe Z (degrés)


Dépannage


OpenTrack ne reçoit pas de données


  1. Vérifiez qu'OpenTrack fonctionne : Assurez-vous qu'OpenTrack est démarré et écoute sur le port 4242
  2. Vérifiez le pare-feu : Le pare-feu Windows peut bloquer le port UDP 4242
  • Ajoutez une exception pour OpenTrack dans le pare-feu Windows
  • Ou désactivez temporairement le pare-feu pour tester
  1. Vérifiez les paramètres de PlayAbility : Confirmez que « Enable OpenTrack Output » est activé
  2. Vérifiez la détection faciale : Assurez-vous que votre webcam est active et que la détection faciale fonctionne
  • Cherchez l'indicateur de détection faciale dans PlayAbility
  • Assurez-vous d'être face à la caméra avec un bon éclairage


Données non fluides


  1. Éclairage : Assurez-vous d'avoir un bon éclairage sur votre visage
  2. Position de la caméra : Positionnez votre caméra pour qu'elle ait une vue claire de votre visage
  3. Calibration : Dans PlayAbility, vous pourriez avoir besoin de calibrer le suivi de tête pour une meilleure précision


OpenTrack n'affiche aucun mouvement


  1. Vérifiez l'entrée : Dans OpenTrack, vérifiez que la source d'entrée montre de l'activité
  2. Vérifiez le mapping : Assurez-vous que le mapping d'entrée d'OpenTrack est correct
  3. Testez avec une autre source : Essayez d'utiliser l'entrée de test intégrée d'OpenTrack pour vérifier que la sortie fonctionne


Port déjà utilisé


Si vous obtenez une erreur indiquant que le port 4242 est déjà utilisé :


  1. Vérifiez les autres instances : Assurez-vous qu'aucune autre application n'utilise le port 4242


Configuration avancée


Ajuster la sensibilité


Si les mouvements de tête sont trop sensibles ou pas assez :


  1. Dans OpenTrack, utilisez l'onglet Mapping pour ajuster les courbes de sensibilité
  2. Ajustez les paramètres de Smoothing pour réduire les tremblements
  3. Utilisez les options de Filtering pour affiner la réactivité


Ajustements du système de coordonnées


Si le suivi semble inversé ou pivoté incorrectement :


  1. Dans OpenTrack, utilisez l'onglet Mapping
  2. Ajustez les mappings d'axes et inversez les axes si nécessaire
  3. Utilisez l'option Relative translation si nécessaire


Ressources supplémentaires



Notes


  • PlayAbility envoie des données en continu tant que la sortie OpenTrack est activée
  • La connexion est unidirectionnelle : PlayAbility → OpenTrack
  • Aucune configuration n'est nécessaire dans PlayAbility au-delà de l'activation du toggle
  • La détection faciale doit être activée pour que la sortie OpenTrack fonctionne (cela se fait automatiquement)

Mis à jour le : 11/02/2026