Control de Sonido Abierto (OSC)
Envía comandos a DMXDesktop y recibe transmisiones de estado a través de 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 actuaciones musicales o control de espectáculos. DMXDesktop implementa OSC para comunicación bidireccional: recibe comandos de controladores externos y transmite cambios de estado a otras aplicaciones.
Cómo Funciona
DMXDesktop soporta tanto OSC Input como Output. El servidor OSC Input escucha mensajes entrantes para controlar varios aspectos del software. OSC Output transmite cambios de estado y eventos a aplicaciones externas, permitiendo la sincronización en tiempo real con software de video, visualizadores e integraciones personalizadas. Ambos soportan el protocolo UDP para comunicación de baja latencia.
Comenzando
- Abre DMXDesktop y navega a Configuraciones → General
- En la sección OSC, encontrarás:
- Interruptor de Habilitar/Deshabilitar OSC Input
- Selección de Interfaz de Red
- Número de Puerto de Entrada (predeterminado: 8000)
- Selección de Protocolo (UDP/TCP)
- Interruptor de Habilitar/Deshabilitar OSC Output
- Host y Puerto de Salida (predeterminado: 127.0.0.1:9000)
- 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, usa una red dedicada o conexión WiFi de 5GHz
- Para OSC Output, configura la IP y el puerto del host objetivo en Configuraciones
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 OSC Input
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 apagón |
| /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 que se están ejecutando actualmente |
| /effects/bpm | float (0-1) | Establece 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 la 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 DJ | ||
| /dj/app/{app} | musicplayer|virtualdj|traktor | Alterna la aplicación 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 |
| CONTROLES DE PILA | ||
| /stack/{id}/go | ninguno | Dispara el siguiente cue en la pila especificada |
| /stack/{id}/back | ninguno | Retrocede al cue anterior |
| /stack/{id}/halt | ninguno | Congela la transición actual del crossfade |
| /stack/{id}/stop | ninguno | Detiene la reproducción en la pila especificada |
| /stack/{id}/level | float (0-1) | Establece el nivel maestro de la pila |
| EJECUTAR GRID | ||
| /execute/{row}/{col} | ninguno | Activa el botón de ejecutar en la posición especificada |
Mensajes OSC Output
DMXDesktop transmite estado y eventos a aplicaciones externas a través de OSC. Configura el host y el puerto objetivo en Configuraciones. 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 (onda, trueno, etc.)Audio y BPM
/dmxdesktop/v1/bpm float (valor BPM)/dmxdesktop/v1/beat float, int, int, float (bpm, ts_high, ts_low, confianza)/dmxdesktop/v1/audio/level float 0-1 (nivel RMS)/dmxdesktop/v1/audio/energy float 0-1 (nivel de energía)Effect Cues
/dmxdesktop/v1/cue/active string (nombre del cue o "")/dmxdesktop/v1/cue/name string (cue actual)/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 (nombre del siguiente cue)Pilas de Cues
/dmxdesktop/v1/stack/{id}/step int (índice del paso)/dmxdesktop/v1/stack/{id}/fading int 0|1/dmxdesktop/v1/stack/{id}/paused int 0|1Ediciones en Vivo & Sobrescrituras
/dmxdesktop/v1/liveedit/{id} int 0|1/dmxdesktop/v1/liveedit/group/{id} int 0|1/dmxdesktop/v1/override/color string (ID de paleta o "")/dmxdesktop/v1/override/position string (preset o "")DJ Mode
/dmxdesktop/v1/dj/enabled int 0|1/dmxdesktop/v1/dj/app string (nombre de la app o "")/dmxdesktop/v1/dj/master int 1-4 (deck maestro)/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 - Título)/dmxdesktop/v1/dj/deck{1-4}/loaded int 0|1 (track cargado)/dmxdesktop/v1/dj/deck{1-4}/loading int 0|1 (analizando)/dmxdesktop/v1/dj/deck{1-4}/showready int 0|1 (show DMX listo)/dmxdesktop/v1/dj/deck{1-4}/vu float (nivel del medidor VU)QuickShow - Efectos de Haz
/dmxdesktop/v1/quickshow/beam string (nombre del efecto o "")/dmxdesktop/v1/quickshow/beam/speed int (valor del control deslizante en bruto)/dmxdesktop/v1/quickshow/beam/phase int (valor del control deslizante en bruto)/dmxdesktop/v1/quickshow/beam/background int (valor del control deslizante en bruto)/dmxdesktop/v1/quickshow/beam/spread int (valor del control deslizante en bruto)/dmxdesktop/v1/quickshow/beam/intensity int (valor del control deslizante en bruto)QuickShow - Efectos de Movimiento
/dmxdesktop/v1/quickshow/move string (nombre del efecto o "")/dmxdesktop/v1/quickshow/move/speed int (valor del control deslizante en bruto)/dmxdesktop/v1/quickshow/move/size int (valor del control deslizante en bruto)/dmxdesktop/v1/quickshow/move/phase int (valor del control deslizante en bruto)/dmxdesktop/v1/quickshow/move/fanning int (valor del control deslizante en bruto)/dmxdesktop/v1/quickshow/move/direction int -1|0|1QuickShow - General
/dmxdesktop/v1/quickshow/theme int (ID del tema)/dmxdesktop/v1/quickshow/themecount int (8|16|24|32)/dmxdesktop/v1/quickshow/preset string (ID del preset o "")/dmxdesktop/v1/quickshow/groups string (array JSON)/dmxdesktop/v1/quickshow/groups/move string (array JSON)/dmxdesktop/v1/quickshow/stopall int 1 (evento de pulso)QuickShow - Codificadores
/dmxdesktop/v1/quickshow/encoder/beam/{id} int 0-255 (valor DMX)/dmxdesktop/v1/quickshow/encoder/move/{id} int 0-255 (valor DMX)Los IDs de los encoders están en el formato: beam_aux_{groupId}_{channelKey} o move_aux_{groupId}_{channelKey}
Nota: OSC Output requiere una suscripción de pago y debe ser habilitado en Configuraciones. 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.