Ouvrir le contrôle de son (OSC)
Envoyez des commandes à DMXDesktop et recevez des diffusions d'état via OSC
Qu'est-ce que l'OSC ?
Open Sound Control (OSC) est un protocole pour le réseautage de synthétiseurs sonores, d'ordinateurs et d'autres dispositifs multimédias à des fins telles que la performance musicale ou le contrôle de spectacle. DMXDesktop implémente l'OSC pour une communication bidirectionnelle — recevoir des commandes de contrôleurs externes et diffuser des changements d'état vers d'autres applications.
Comment ça fonctionne
DMXDesktop prend en charge à la fois l'entrée et la sortie OSC. Le serveur OSC Input écoute les messages entrants pour contrôler divers aspects du logiciel. OSC Output diffuse des changements d'état et des événements vers des applications externes, permettant une synchronisation en temps réel avec des logiciels vidéo, des visualisateurs et des intégrations personnalisées. Les deux prennent en charge le protocole UDP pour une communication à faible latence.
Commencer
- Ouvrez DMXDesktop et naviguez vers Paramètres → Général
- Dans la section OSC, vous trouverez :
- Basculer Activer/Désactiver l'entrée OSC
- Sélection de l'interface réseau
- Numéro de port d'entrée (par défaut : 8000)
- Sélection du protocole (UDP/TCP)
- Basculer Activer/Désactiver la sortie OSC
- Hôte et port de sortie (par défaut : 127.0.0.1:9000)
- Le service de découverte fonctionne sur le port 9000 et permet aux applications compatibles de trouver automatiquement DMXDesktop sur le réseau
Connexion avec TouchOSC
TouchOSC est un outil populaire pour contrôler une multitude de différents types d'applications et peut être utilisé pour contrôler DMXDesktop via le protocole OSC.
Veuillez noter : TouchOSC est un logiciel payant, veuillez consulter le site officiel pour plus de détails.
- Téléchargez et installez TouchOSC sur votre appareil :
- iOS : App Store
- Android : Google Play
- Desktop : Desktop
- Ouvrez TouchOSC et créez une nouvelle connexion :
- Protocole : OSC
- Hôte : L'adresse IP de votre ordinateur (affichée dans les paramètres de DMXDesktop)
- Port d'envoi : 8000 (par défaut)
- Port de réception : 9000 (pour le service de découverte)
- Utilisez la fonction de découverte dans TouchOSC pour trouver automatiquement DMXDesktop sur votre réseau
- Créez votre mise en page en utilisant les chemins OSC listés dans le tableau ci-dessous
Conseils Réseau
- Assurez-vous que votre appareil et votre ordinateur sont sur le même réseau
- Si vous utilisez un pare-feu, autorisez les connexions entrantes sur les ports 8000 et 9000
- Pour des performances optimales, utilisez un réseau dédié ou une connexion WiFi 5GHz
- Pour la sortie OSC, configurez l'IP et le port de l'hôte cible dans les paramètres
Ressources Supplémentaires
- Site Officiel de l'OSC - En savoir plus sur le protocole OSC
- Documentation TouchOSC - Guide détaillé pour TouchOSC
- Spécification du Protocole OSC - Détails techniques du protocole OSC
Commandes d'Entrée OSC
Envoyez ces commandes à DMXDesktop pour contrôler votre éclairage. Tous les chemins sont sensibles à la casse.
| Chemin OSC | Paramètres | Description |
|---|---|---|
| COMMANDES MAÎTRES | ||
| /master/dimmer | float (0-1) | Contrôle l'intensité du variateur maître |
| EFFETS EN DIRECT | ||
| /live/strobe/{on|off|pulse} | aucun | Contrôle l'état du stroboscope |
| /live/blackout/{on|off|pulse} | aucun | Contrôle l'état de coupure |
| /live/blinder/{on|off|pulse} | aucun | Contrôle l'état du blinder |
| /live/freeze/{on|off|pulse} | aucun | Contrôle l'état de gel |
| /live/fog/{on|off|pulse} | aucun | Contrôle l'état de la machine à fumée |
| EFFETS SPÉCIAUX | ||
| /effects/{effect}/start | aucun | Démarre l'effet spécifié (vague, paparazzi, balayage de couleurs, tonnerre, pulsation, étincelle, aléatoire) |
| /effects/{effect}/stop | aucun | Arrête l'effet spécial spécifié |
| /effects/stop | aucun | Arrête tous les effets spéciaux en cours d'exécution |
| /effects/bpm | float (0-1) | Définit le BPM pour le timing des effets spéciaux (mappe 0-1 à 60-200 BPM) |
| ÉDITIONS EN DIRECT | ||
| /live/edit/{action}/{name} | action : enable|disable|toggle | Contrôle l'état d'édition en direct par nom |
| /live/edit/group/{action}/{name} | action : enable|disable|toggle | Contrôle l'état du groupe d'édition en direct par nom |
| /live/edit/disable-all | aucun | Désactive toutes les éditions en direct |
| COMMANDES DE CUE | ||
| /cue/effect/play/{name} | string | Joue le cue d'effet spécifique par nom |
| /cue/effect/{action} | play|stop|next|prev | Contrôle la navigation de lecture du cue d'effet |
| COMMANDES DJ | ||
| /dj/app/{app} | musicplayer|virtualdj|traktor | Basculer l'application DJ spécifique |
| /dj/deck{1|2}/{action} | play|stop|eject | Commandes de transport du plateau |
| /dj/deck{1|2}/volume | float (0-1) | Contrôle le volume du plateau |
| /dj/crossfader | float (0-1) | Contrôle la position du crossfader |
| CONTRÔLE DMX DIRECT | ||
| /dmx/{universe}/{channel} | float (0-1) | Définit la valeur du canal DMX (mappe 0-1 à 0-255) |
| /dmx/{universe}/{channel}/clear | aucun | Efface la substitution du canal DMX |
| /dmx/clear | aucun | Efface toutes les substitutions de canaux DMX |
| COMMANDES DE PILE | ||
| /stack/{id}/go | aucun | Déclenche le prochain cue dans la pile spécifiée |
| /stack/{id}/back | aucun | Reculer au cue précédent |
| /stack/{id}/halt | aucun | Gèle la transition actuelle du crossfade |
| /stack/{id}/stop | aucun | Arrête la lecture sur la pile spécifiée |
| /stack/{id}/level | float (0-1) | Définit le niveau maître de la pile |
| GRILLE D'EXÉCUTION | ||
| /execute/{row}/{col} | aucun | Déclenche le bouton de la grille d'exécution à la position spécifiée |
Messages de Sortie OSC
DMXDesktop diffuse des états et des événements vers des applications externes via OSC. Configurez l'hôte et le port cibles dans les paramètres. Disponible à partir de v1.0.46
Contrôles en Direct
/dmxdesktop/v1/master float 0-1 (0-100%)/dmxdesktop/v1/blackout int 0|1/dmxdesktop/v1/strobe int 0|1/dmxdesktop/v1/blinder int 0|1/dmxdesktop/v1/freeze int 0|1/dmxdesktop/v1/fog int 0|1/dmxdesktop/v1/effect int 0|1/dmxdesktop/v1/specialeffect/{name} int 0|1 (vague, tonnerre, etc.)Audio & BPM
/dmxdesktop/v1/bpm float (valeur BPM)/dmxdesktop/v1/beat float, int, int, float (bpm, ts_high, ts_low, confiance)/dmxdesktop/v1/audio/level float 0-1 (niveau RMS)/dmxdesktop/v1/audio/energy float 0-1 (niveau d'énergie)Effect Cues
/dmxdesktop/v1/cue/active string (nom de la cue ou "")/dmxdesktop/v1/cue/name string (cue actuelle)/dmxdesktop/v1/cue/action string (play|stop)/dmxdesktop/v1/cue/lifecycle string (fadeIn/OutStarted/Finished)/dmxdesktop/v1/cue/lifecycle/duration int (ms)/dmxdesktop/v1/cue/lifecycle/newCue string (nom de la prochaine cue)Piles de Cues
/dmxdesktop/v1/stack/{id}/step int (index de l'étape)/dmxdesktop/v1/stack/{id}/fading int 0|1/dmxdesktop/v1/stack/{id}/paused int 0|1Modifications en Direct & Remplacements
/dmxdesktop/v1/liveedit/{id} int 0|1/dmxdesktop/v1/liveedit/group/{id} int 0|1/dmxdesktop/v1/override/color string (ID de la palette ou "")/dmxdesktop/v1/override/position string (preset ou "")DJ Mode
/dmxdesktop/v1/dj/enabled int 0|1/dmxdesktop/v1/dj/app string (nom de l'application ou "")/dmxdesktop/v1/dj/master int 1-4 (deck maître)/dmxdesktop/v1/dj/crossfader float 0-1/dmxdesktop/v1/dj/deck{1-4}/playing int 0|1/dmxdesktop/v1/dj/deck{1-4}/paused int 0|1/dmxdesktop/v1/dj/deck{1-4}/track string (Artiste - Titre)/dmxdesktop/v1/dj/deck{1-4}/loaded int 0|1 (piste chargée)/dmxdesktop/v1/dj/deck{1-4}/loading int 0|1 (analyse en cours)/dmxdesktop/v1/dj/deck{1-4}/showready int 0|1 (spectacle DMX prêt)/dmxdesktop/v1/dj/deck{1-4}/vu float (niveau du VU mètre)QuickShow - Effets de faisceau
/dmxdesktop/v1/quickshow/beam string (nom de l'effet ou "")/dmxdesktop/v1/quickshow/beam/speed int (valeur brute du curseur)/dmxdesktop/v1/quickshow/beam/phase int (valeur brute du curseur)/dmxdesktop/v1/quickshow/beam/background int (valeur brute du curseur)/dmxdesktop/v1/quickshow/beam/spread int (valeur brute du curseur)/dmxdesktop/v1/quickshow/beam/intensity int (valeur brute du curseur)QuickShow - Effets de mouvement
/dmxdesktop/v1/quickshow/move string (nom de l'effet ou "")/dmxdesktop/v1/quickshow/move/speed int (valeur brute du curseur)/dmxdesktop/v1/quickshow/move/size int (valeur brute du curseur)/dmxdesktop/v1/quickshow/move/phase int (valeur brute du curseur)/dmxdesktop/v1/quickshow/move/fanning int (valeur brute du curseur)/dmxdesktop/v1/quickshow/move/direction int -1|0|1QuickShow - Général
/dmxdesktop/v1/quickshow/theme int (ID du thème)/dmxdesktop/v1/quickshow/themecount int (8|16|24|32)/dmxdesktop/v1/quickshow/preset string (ID du preset ou "")/dmxdesktop/v1/quickshow/groups string (tableau JSON)/dmxdesktop/v1/quickshow/groups/move string (tableau JSON)/dmxdesktop/v1/quickshow/stopall int 1 (événement de pulsation)QuickShow - Encodeurs
/dmxdesktop/v1/quickshow/encoder/beam/{id} int 0-255 (valeur DMX)/dmxdesktop/v1/quickshow/encoder/move/{id} int 0-255 (valeur DMX)Les ID des encodeurs sont au format : beam_aux_{groupId}_{channelKey} ou move_aux_{groupId}_{channelKey}
Note : La sortie OSC nécessite un abonnement payant et doit être activée dans les paramètres. Le port par défaut est 9000.
Les horodatages des battements sont divisés en deux entiers 32 bits (ts_high, ts_low) car l'OSC ne prend pas en charge les valeurs 64 bits.