Apri il Controllo del Suono (OSC)
Invia comandi a DMXDesktop e ricevi trasmissioni di stato tramite OSC
Che cos'è l'OSC?
Open Sound Control (OSC) è un protocollo per il networking di sintetizzatori audio, computer e altri dispositivi multimediali per scopi come performance musicali o controllo di spettacoli. DMXDesktop implementa l'OSC per comunicazione bidirezionale — ricevi comandi da controller esterni e trasmetti cambiamenti di stato ad altre applicazioni.
Come Funziona
DMXDesktop supporta sia l'Input che l'Output OSC. Il server OSC Input ascolta i messaggi in arrivo per controllare vari aspetti del software. OSC Output trasmette cambiamenti di stato ed eventi ad applicazioni esterne, consentendo la sincronizzazione in tempo reale con software video, visualizzatori e integrazioni personalizzate. Entrambi supportano il protocollo UDP per comunicazione a bassa latenza.
Iniziare
- Apri DMXDesktop e vai su Impostazioni → Generale
- Nella sezione OSC, troverai:
- Interruttore per abilitare/disabilitare l'OSC Input
- Selezione dell'interfaccia di rete
- Numero di porta di input (predefinito: 8000)
- Selezione del protocollo (UDP/TCP)
- Interruttore per abilitare/disabilitare l'OSC Output
- Host e Porta di output (predefinito: 127.0.0.1:9000)
- Il servizio di scoperta funziona sulla porta 9000 e consente alle app compatibili di trovare automaticamente DMXDesktop sulla rete
Collegamento con TouchOSC
TouchOSC è uno strumento popolare per controllare moltitudini di diversi tipi di applicazioni e può essere utilizzato per controllare DMXDesktop tramite il protocollo OSC.
Si prega di notare: TouchOSC è un software a pagamento, si prega di fare riferimento al sito ufficiale per dettagli.
- Scarica e installa TouchOSC sul tuo dispositivo:
- iOS: App Store
- Android: Google Play
- Desktop: Desktop
- Apri TouchOSC e crea una nuova connessione:
- Protocollo: OSC
- Host: Indirizzo IP del tuo computer (mostrato nelle impostazioni di DMXDesktop)
- Porta di invio: 8000 (predefinito)
- Porta di ricezione: 9000 (per il servizio di scoperta)
- Utilizza la funzione di scoperta in TouchOSC per trovare automaticamente DMXDesktop sulla tua rete
- Crea il tuo layout utilizzando i percorsi OSC elencati nella tabella sottostante
Suggerimenti di Rete
- Assicurati che il tuo dispositivo e computer siano sulla stessa rete
- Se utilizzi un firewall, consenti le connessioni in entrata sulle porte 8000 e 9000
- Per prestazioni ottimali, utilizza una rete dedicata o una connessione WiFi a 5GHz
- Per l'OSC Output, configura l'IP e la porta dell'host di destinazione nelle Impostazioni
Risorse Aggiuntive
- Sito Ufficiale OSC - Scopri di più sul protocollo OSC
- Documentazione TouchOSC - Guida dettagliata per TouchOSC
- Specifiche del Protocollo OSC - Dettagli tecnici del protocollo OSC
Comandi OSC Input
Invia questi comandi a DMXDesktop per controllare l'illuminazione. Tutti i percorsi sono case-sensitive.
| Percorso OSC | Parametri | Descrizione |
|---|---|---|
| CONTROLLI MASTER | ||
| /master/dimmer | float (0-1) | Controlla l'intensità del dimmer master |
| EFFETTI LIVE | ||
| /live/strobe/{on|off|pulse} | none | Controlla lo stato dello stroboscopio |
| /live/blackout/{on|off|pulse} | none | Controlla lo stato del blackout |
| /live/blinder/{on|off|pulse} | none | Controlla lo stato del blinder |
| /live/freeze/{on|off|pulse} | none | Controlla lo stato del freeze |
| /live/fog/{on|off|pulse} | none | Controlla lo stato della macchina del fumo |
| EFFETTI SPECIALI | ||
| /effects/{effect}/start | none | Avvia l'effetto specificato (wave, paparazzi, colorsweep, thunder, pulse, sparkle, random) |
| /effects/{effect}/stop | none | Ferma l'effetto speciale specificato |
| /effects/stop | none | Ferma tutti gli effetti speciali attualmente in esecuzione |
| /effects/bpm | float (0-1) | Imposta il BPM per il timing degli effetti speciali (mappa 0-1 a 60-200 BPM) |
| MODIFICHE LIVE | ||
| /live/edit/{action}/{name} | action: enable|disable|toggle | Controlla lo stato della modifica live per nome |
| /live/edit/group/{action}/{name} | action: enable|disable|toggle | Controlla lo stato del gruppo di modifiche live per nome |
| /live/edit/disable-all | none | Disabilita tutte le modifiche live |
| CONTROLLI CUE | ||
| /cue/effect/play/{name} | string | Riproduce il cue effetto specifico per nome |
| /cue/effect/{action} | play|stop|next|prev | Controlla la navigazione della riproduzione del cue effetto |
| CONTROLLI DJ | ||
| /dj/app/{app} | musicplayer|virtualdj|traktor | Attiva/disattiva un'applicazione DJ specifica |
| /dj/deck{1|2}/{action} | play|stop|eject | Controlli di trasporto del deck |
| /dj/deck{1|2}/volume | float (0-1) | Controlla il volume del deck |
| /dj/crossfader | float (0-1) | Controlla la posizione del crossfader |
| CONTROLLO DMX DIRETTO | ||
| /dmx/{universe}/{channel} | float (0-1) | Imposta il valore del canale DMX (mappa 0-1 a 0-255) |
| /dmx/{universe}/{channel}/clear | none | Cancella l'override del canale DMX |
| /dmx/clear | none | Cancella TUTTI gli override dei canali DMX |
| CONTROLLI STACK | ||
| /stack/{id}/go | none | Attiva il prossimo cue nello stack specificato |
| /stack/{id}/back | none | Torna al cue precedente |
| /stack/{id}/halt | none | Congela il crossfade attuale a metà transizione |
| /stack/{id}/stop | none | Ferma la riproduzione nello stack specificato |
| /stack/{id}/level | float (0-1) | Imposta il livello master dello stack |
| ESEGUIRE GRIGLIA | ||
| /execute/{row}/{col} | none | Attiva il pulsante della griglia di esecuzione nella posizione specificata |
Messaggi OSC Output
DMXDesktop trasmette stati ed eventi ad applicazioni esterne tramite OSC. Configura l'host e la porta di destinazione nelle Impostazioni. Disponibile dalla v1.0.46
Controlli Live
/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 (onda, tuono, ecc.)Audio & BPM
/dmxdesktop/v1/bpm float (valore BPM)/dmxdesktop/v1/beat float, int, int, float (bpm, ts_high, ts_low, confidenza)/dmxdesktop/v1/audio/level float 0-1 (livello RMS)/dmxdesktop/v1/audio/energy float 0-1 (livello di energia)Effect Cues
/dmxdesktop/v1/cue/active string (nome del cue o "")/dmxdesktop/v1/cue/name string (cue attuale)/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 (nome del prossimo cue)Cue Stacks
/dmxdesktop/v1/stack/{id}/step int (indice del passo)/dmxdesktop/v1/stack/{id}/fading int 0|1/dmxdesktop/v1/stack/{id}/paused int 0|1Modifiche Live & Sovrapposizioni
/dmxdesktop/v1/liveedit/{id} int 0|1/dmxdesktop/v1/liveedit/group/{id} int 0|1/dmxdesktop/v1/override/color string (ID palette o "")/dmxdesktop/v1/override/position string (preset o "")DJ Mode
/dmxdesktop/v1/dj/enabled int 0|1/dmxdesktop/v1/dj/app string (nome dell'app o "")/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 (Artista - Titolo)/dmxdesktop/v1/dj/deck{1-4}/loaded int 0|1 (traccia caricata)/dmxdesktop/v1/dj/deck{1-4}/loading int 0|1 (analizzando)/dmxdesktop/v1/dj/deck{1-4}/showready int 0|1 (DMX show pronto)/dmxdesktop/v1/dj/deck{1-4}/vu float (livello VU meter)QuickShow - Effetti Beam
/dmxdesktop/v1/quickshow/beam string (nome dell'effetto o "")/dmxdesktop/v1/quickshow/beam/speed int (valore slider grezzo)/dmxdesktop/v1/quickshow/beam/phase int (valore slider grezzo)/dmxdesktop/v1/quickshow/beam/background int (valore slider grezzo)/dmxdesktop/v1/quickshow/beam/spread int (valore slider grezzo)/dmxdesktop/v1/quickshow/beam/intensity int (valore slider grezzo)QuickShow - Effetti di Movimento
/dmxdesktop/v1/quickshow/move string (nome dell'effetto o "")/dmxdesktop/v1/quickshow/move/speed int (valore slider grezzo)/dmxdesktop/v1/quickshow/move/size int (valore slider grezzo)/dmxdesktop/v1/quickshow/move/phase int (valore slider grezzo)/dmxdesktop/v1/quickshow/move/fanning int (valore slider grezzo)/dmxdesktop/v1/quickshow/move/direction int -1|0|1QuickShow - Generale
/dmxdesktop/v1/quickshow/theme int (ID tema)/dmxdesktop/v1/quickshow/themecount int (8|16|24|32)/dmxdesktop/v1/quickshow/preset string (ID preset o "")/dmxdesktop/v1/quickshow/groups string (array JSON)/dmxdesktop/v1/quickshow/groups/move string (array JSON)/dmxdesktop/v1/quickshow/stopall int 1 (evento di impulso)QuickShow - Encoder
/dmxdesktop/v1/quickshow/encoder/beam/{id} int 0-255 (valore DMX)/dmxdesktop/v1/quickshow/encoder/move/{id} int 0-255 (valore DMX)Gli ID degli encoder sono nel formato: beam_aux_{groupId}_{channelKey} o move_aux_{groupId}_{channelKey}
Nota: L'OSC Output richiede un abbonamento a pagamento e deve essere abilitato nelle Impostazioni. La porta predefinita è 9000.
I timestamp dei battiti sono suddivisi in due interi a 32 bit (ts_high, ts_low) poiché l'OSC non supporta valori a 64 bit.