Ouvrir le contrôle de son (OSC)
Contrôlez DMXDesktop à distance en utilisant le protocole 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 permettre le contrôle à distance depuis divers dispositifs et applications.
Comment ça marche
DMXDesktop exécute un serveur OSC qui écoute les messages entrants. Ces messages peuvent contrôler divers aspects du logiciel, des fonctions de base comme le contrôle du dimmer principal à des déclenchements d'effets complexes. Le serveur prend en charge les protocoles UDP et TCP, l'UDP étant le plus couramment utilisé.
Commencer
- Ouvrez DMXDesktop et naviguez vers Settings → General
- Dans la section OSC, vous trouverez :
- Basculer l'activation/désactivation de l'OSC
- Sélection d'interface réseau (choisissez votre interface réseau préférée)
- Numéro de port (par défaut : 8000)
- Sélection de protocole (UDP/TCP)
- 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 vous référer au 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
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 à brouillard |
| 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 actuellement en cours |
| /effects/bpm | float (0-1) | Définit le BPM pour le timing des effets spéciaux (map 0-1 à 60-200 BPM) |
| ÉDITIONS EN DIRECT | ||
| /live/edit/{action}/{name} | action : enable|disable|toggle | Contrôle l'état de l'é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 | Contrôles de transport de la platine |
| /dj/deck{1|2}/volume | float (0-1) | Contrôle le volume de la platine |
| /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 (map 0-1 à 0-255) |
| /dmx/{universe}/{channel}/clear | aucun | Efface la surcharge du canal DMX |
| /dmx/clear | aucun | Efface TOUTES les surcharges de canaux DMX |
Messages de sortie OSC
DMXDesktop diffuse l'état et les événements vers des applications externes via OSC. Configurez l'hôte cible et le port 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 (wave, thunder, etc.)Audio & BPM
/dmxdesktop/v1/bpm float (BPM value)/dmxdesktop/v1/beat float, int, int, float (bpm, ts_high, ts_low, confidence)/dmxdesktop/v1/audio/level float 0-1 (RMS level)/dmxdesktop/v1/audio/energy float 0-1 (energy level)Effect Cues
/dmxdesktop/v1/cue/active string (cue name or "")/dmxdesktop/v1/cue/name string (current cue)/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 (next cue name)Éditions en direct & Surcharges
/dmxdesktop/v1/liveedit/{id} int 0|1/dmxdesktop/v1/liveedit/group/{id} int 0|1/dmxdesktop/v1/override/color string (palette ID or "")/dmxdesktop/v1/override/position string (preset or "")DJ Mode
/dmxdesktop/v1/dj/enabled int 0|1/dmxdesktop/v1/dj/app string (app name or "")/dmxdesktop/v1/dj/master int 1-4 (master deck)/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 (Artist - Title)/dmxdesktop/v1/dj/deck{1-4}/loaded int 0|1 (track loaded)/dmxdesktop/v1/dj/deck{1-4}/loading int 0|1 (analyzing)/dmxdesktop/v1/dj/deck{1-4}/showready int 0|1 (DMX show ready)/dmxdesktop/v1/dj/deck{1-4}/vu float (VU meter level)QuickShow - Effets de faisceau
/dmxdesktop/v1/quickshow/beam string (effect name or "")/dmxdesktop/v1/quickshow/beam/speed int (raw slider value)/dmxdesktop/v1/quickshow/beam/phase int (raw slider value)/dmxdesktop/v1/quickshow/beam/background int (raw slider value)/dmxdesktop/v1/quickshow/beam/spread int (raw slider value)/dmxdesktop/v1/quickshow/beam/intensity int (raw slider value)QuickShow - Effets de mouvement
/dmxdesktop/v1/quickshow/move string (effect name or "")/dmxdesktop/v1/quickshow/move/speed int (raw slider value)/dmxdesktop/v1/quickshow/move/size int (raw slider value)/dmxdesktop/v1/quickshow/move/phase int (raw slider value)/dmxdesktop/v1/quickshow/move/fanning int (raw slider value)/dmxdesktop/v1/quickshow/move/direction int -1|0|1QuickShow - Général
/dmxdesktop/v1/quickshow/theme int (theme ID)/dmxdesktop/v1/quickshow/themecount int (8|16|24|32)/dmxdesktop/v1/quickshow/preset string (preset ID or "")/dmxdesktop/v1/quickshow/groups string (JSON array)/dmxdesktop/v1/quickshow/groups/move string (JSON array)/dmxdesktop/v1/quickshow/stopall int 1 (pulse event)QuickShow - Encodeurs
/dmxdesktop/v1/quickshow/encoder/beam/{id} int 0-255 (DMX value)/dmxdesktop/v1/quickshow/encoder/move/{id} int 0-255 (DMX value)Les ID des encodeurs sont au format : beam_aux_{groupId}_{channelKey} ou move_aux_{groupId}_{channelKey}
Remarque : 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 de battement sont divisés en deux entiers 32 bits (ts_high, ts_low) car OSC ne prend pas en charge les valeurs 64 bits.