Control de Sonido Abierto (OSC)
Controla DMXDesktop de forma remota utilizando el protocolo OSC
¿Qué es OSC?
Open Sound Control (OSC) es un protocolo para la interconexión de sintetizadores de sonido, computadoras y otros dispositivos multimedia con fines como la actuación musical o el control de espectáculos. DMXDesktop implementa OSC para permitir el control remoto desde varios dispositivos y aplicaciones.
Cómo Funciona
DMXDesktop ejecuta un servidor OSC que escucha mensajes entrantes. Estos mensajes pueden controlar varios aspectos del software, desde funciones básicas como el control del atenuador maestro hasta el desencadenamiento de efectos complejos. El servidor admite tanto los protocolos UDP como TCP, siendo UDP el más utilizado.
Introducción
- Abre DMXDesktop y navega a Configuración → General
- En la sección OSC, encontrarás:
- Interruptor de habilitar/deshabilitar OSC
- Selección de interfaz de red (elige tu interfaz de red preferida)
- Número de puerto (predeterminado: 8000)
- Selección de protocolo (UDP/TCP)
- El servicio de descubrimiento se ejecuta en el puerto 9000 y permite que aplicaciones compatibles encuentren automáticamente DMXDesktop en la red
Conectando con TouchOSC
TouchOSC es una herramienta popular para controlar multitudes de diferentes tipos de aplicaciones, y se puede usar para controlar DMXDesktop a través del Protocolo OSC.
Por favor nota: TouchOSC es un software de pago, consulta el sitio web oficial para más detalles.
- Descarga e instala TouchOSC en tu dispositivo:
- iOS: App Store
- Android: Google Play
- Escritorio: Escritorio
- Abre TouchOSC y crea una nueva conexión:
- Protocolo: OSC
- Host: La dirección IP de tu computadora (mostrada en la configuración de DMXDesktop)
- Puerto de envío: 8000 (predeterminado)
- Puerto de recepción: 9000 (para el servicio de descubrimiento)
- Usa la función de descubrimiento en TouchOSC para encontrar automáticamente DMXDesktop en tu red
- Crea tu diseño utilizando las rutas OSC listadas en la tabla a continuación
Consejos de Red
- Asegúrate de que tu dispositivo y computadora estén en la misma red
- Si usas un firewall, permite conexiones entrantes en los puertos 8000 y 9000
- Para un rendimiento óptimo, utiliza una red dedicada o conexión WiFi de 5GHz
Recursos Adicionales
- Sitio Web Oficial de OSC - Aprende más sobre el protocolo OSC
- Documentación de TouchOSC - Guía detallada para TouchOSC
- Especificación del Protocolo OSC - Detalles técnicos del protocolo OSC
Comandos de Entrada OSC
Envía estos comandos a DMXDesktop para controlar tu iluminación. Todas las rutas son sensibles a mayúsculas y minúsculas.
| Ruta OSC | Parámetros | Descripción |
|---|---|---|
| CONTROLES MAESTROS | ||
| /master/dimmer | float (0-1) | Controla la intensidad del atenuador maestro |
| EFECTOS EN VIVO | ||
| /live/strobe/{on|off|pulse} | ninguno | Controla el estado del estroboscopio |
| /live/blackout/{on|off|pulse} | ninguno | Controla el estado de apagado |
| /live/blinder/{on|off|pulse} | ninguno | Controla el estado del blinder |
| /live/freeze/{on|off|pulse} | ninguno | Controla el estado de congelación |
| /live/fog/{on|off|pulse} | ninguno | Controla el estado de la máquina de humo |
| EFECTOS ESPECIALES | ||
| /effects/{effect}/start | ninguno | Inicia el efecto especificado (onda, paparazzi, barrido de colores, trueno, pulso, chispa, aleatorio) |
| /effects/{effect}/stop | ninguno | Detiene el efecto especial especificado |
| /effects/stop | ninguno | Detiene todos los efectos especiales en ejecución |
| /effects/bpm | float (0-1) | Establece el BPM para el tiempo de los efectos especiales (mapea 0-1 a 60-200 BPM) |
| EDICIONES EN VIVO | ||
| /live/edit/{action}/{name} | acción: enable|disable|toggle | Controla el estado de edición en vivo por nombre |
| /live/edit/group/{action}/{name} | acción: enable|disable|toggle | Controla el estado del grupo de edición en vivo por nombre |
| /live/edit/disable-all | ninguno | Desactiva todas las ediciones en vivo |
| CONTROLES DE CUE | ||
| /cue/effect/play/{name} | cadena | Reproduce el cue de efecto específico por nombre |
| /cue/effect/{action} | play|stop|next|prev | Controla la navegación de reproducción del cue de efecto |
| CONTROLES DE DJ | ||
| /dj/app/{app} | musicplayer|virtualdj|traktor | Alterna la aplicación de DJ específica |
| /dj/deck{1|2}/{action} | play|stop|eject | Controles de transporte del deck |
| /dj/deck{1|2}/volume | float (0-1) | Controla el volumen del deck |
| /dj/crossfader | float (0-1) | Controla la posición del crossfader |
| CONTROL DMX DIRECTO | ||
| /dmx/{universe}/{channel} | float (0-1) | Establece el valor del canal DMX (mapea 0-1 a 0-255) |
| /dmx/{universe}/{channel}/clear | ninguno | Limpia la anulación del canal DMX |
| /dmx/clear | ninguno | Limpia TODAS las anulaciones de canales DMX |
Mensajes de Salida OSC
DMXDesktop transmite estado y eventos a aplicaciones externas a través de OSC. Configura el host y el puerto de destino en Configuración. Disponible desde v1.0.46
Controles en Vivo
/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 y 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)Ediciones en Vivo y Anulaciones
/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 - Efectos de Haz
/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 - Efectos de Movimiento
/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 - General
/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 - Codificadores
/dmxdesktop/v1/quickshow/encoder/beam/{id} int 0-255 (DMX value)/dmxdesktop/v1/quickshow/encoder/move/{id} int 0-255 (DMX value)Los IDs de los codificadores están en el formato: beam_aux_{groupId}_{channelKey} o move_aux_{groupId}_{channelKey}
Nota: La salida OSC requiere una suscripción paga y debe ser habilitada en Configuración. El puerto predeterminado es 9000.
Las marcas de tiempo de los beats se dividen en dos enteros de 32 bits (ts_high, ts_low) ya que OSC no soporta valores de 64 bits.