Apri il Controllo del Suono (OSC)
Controlla DMXDesktop da remoto utilizzando il protocollo 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 consentire il controllo remoto da vari dispositivi e applicazioni.
Come funziona
DMXDesktop esegue un server OSC che ascolta i messaggi in arrivo. Questi messaggi possono controllare vari aspetti del software, dalle funzioni di base come il controllo del dimmer master a complesse attivazioni di effetti. Il server supporta sia i protocolli UDP che TCP, con UDP che è il più comunemente usato.
Iniziare
- Apri DMXDesktop e vai su Impostazioni → Generale
- Nella sezione OSC, troverai:
- Attiva/Disattiva l'interruttore OSC
- Selezione dell'interfaccia di rete (scegli la tua interfaccia di rete preferita)
- Numero di porta (predefinito: 8000)
- Selezione del protocollo (UDP/TCP)
- 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: L'indirizzo IP del tuo computer (mostrato nelle impostazioni di DMXDesktop)
- Porta di invio: 8000 (predefinita)
- 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 il 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
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 di Input OSC
Invia questi comandi a DMXDesktop per controllare le tue luci. Tutti i percorsi sono sensibili alle maiuscole.
| 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 (onda, paparazzi, colori, tuono, impulso, scintillio, casuale) |
| /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} | azione: enable|disable|toggle | Controlla lo stato della modifica live per nome |
| /live/edit/group/{action}/{name} | azione: 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 l'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 | Pulisce l'override del canale DMX |
| /dmx/clear | none | Pulisce TUTTI gli override dei canali DMX |
Messaggi di Output OSC
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 (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)Modifiche Live & Override
/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 - Effetti Beam
/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 - Effetti di Movimento
/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 - Generale
/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 - Encoder
/dmxdesktop/v1/quickshow/encoder/beam/{id} int 0-255 (DMX value)/dmxdesktop/v1/quickshow/encoder/move/{id} int 0-255 (DMX value)Gli ID degli encoder sono nel formato: beam_aux_{groupId}_{channelKey} o move_aux_{groupId}_{channelKey}
Nota: L'Output OSC richiede un abbonamento a pagamento e deve essere abilitato nelle Impostazioni. La porta predefinita è 9000.
I timestamp dei battiti sono divisi in due interi a 32 bit (ts_high, ts_low) poiché OSC non supporta valori a 64 bit.