--- title: "Contrôle son ouvert (OSC) – DMXDesktop" lang: en source: /fr/open-sound-control --- # 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 1. Ouvrez DMXDesktop et naviguez vers **Paramètres → Général** 2. 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) 3. 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.* 1. Téléchargez et installez TouchOSC sur votre appareil : - iOS : App Store - Android : [Google Play](https://play.google.com/store/apps/details?id=net.hexler.lex&hl=en) - Desktop : Desktop 2. 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) 3. Utilisez la fonction de découverte dans TouchOSC pour trouver automatiquement DMXDesktop sur votre réseau 4. 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|1 ### Modifications 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|1 ### QuickShow - 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. ## Prêt à contrôler vos lumières à distance ? Télécharger DMXDesktop