Treinta acciones, quince feedbacks: inmersión profunda en el módulo Companion

Existen dos filosofías del control de espectáculo por hardware, y la mayoría de los equipos de producción acaban adoptando ambas. La primera filosofía dice que la superficie de control debería estar lo más cerca posible de la aplicación: conexión directa, latencia mínima, cero middleware. La segunda filosofía dice que la superficie de control debería ser un traductor universal que hable con cada sistema de la producción: una superficie, muchas aplicaciones, una pulsación de botón que desencadena acciones sincronizadas en toda la pila. En una sala de control broadcast profesional, ambas coexisten según la criticidad de cada función. Bitfocus Companion es la encarnación de la segunda filosofía. Es una aplicación de escritorio de código abierto que transforma virtualmente cualquier cuadrícula de botones, panel de encoders o superficie táctil en una interfaz de control programable para cientos de sistemas de software y hardware. Stream Deck, Loupedeck, Razer Stream Controller, Logitech MX Creative Console, X-keys y decenas de otros dispositivos funcionan todos a través de la interfaz unificada de Companion. Cuando Timers Studio construyó su módulo Companion, el objetivo fue exponer cada parámetro controlable de la plataforma a este ecosistema de control universal. El módulo proporciona más de treinta acciones. El conjunto completo de transporte está presente: play, pause, stop, reset, next, previous, rewind y ajustes de tiempo de más y menos un minuto. Más allá del transporte básico, el módulo expone acciones para enviar mensajes de los cinco tipos (Standard, Alert, Flash, Takeover y Fullscreen), alternar el modo blackout con sus cuatro variantes (Black, Clock, Color e Image), y controlar el offset del Time Warp. Hay acciones para cambiar entre modos de visualización del timer, recorrer temas y alternar parámetros de diseño individuales. Las acciones administrativas incluyen exportación de sesión, identificación de dispositivos y recarga del player. Cada acción es un punto de conexión entre su superficie física y la señal de programa. Quince canales de feedback proporcionan información visual del estado en tiempo real en la superficie de control, funcionando como un panel de tally lights integrado. El feedback de estado del timer cambia el color del botón según si el timer está en marcha (verde), pausado (amarillo), detenido (gris) o en overtime (rojo). El feedback de estado de mensajes indica si se está mostrando un mensaje actualmente. El feedback de estado de blackout refleja el modo de blackout actual. El feedback de estado de conexión confirma que el módulo tiene una conexión activa con la API de Timers Studio. Estos feedbacks no se obtienen por sondeo; llegan a través de Server-Sent Events, lo que significa que el estado del botón se actualiza tan rápido como el stream SSE entrega el evento, típicamente dentro de 100 a 200 milisegundos del cambio de estado. Veinticinco variables están disponibles para visualización dinámica en etiquetas de botones y para uso en el sistema de triggers y condiciones de Companion. Las variables incluyen el nombre del timer actual, tiempo restante, tiempo transcurrido, duración total, estado del timer, nombre del tema activo, título del studio, nombre del ponente y estado de conexión. Un botón de Companion puede mostrar una etiqueta como "KEYNOTE 04:32" que se actualiza en tiempo real mientras el timer cuenta hacia atrás. Esto elimina la necesidad de mirar un monitor separado para saber qué timer está activo y cuánto tiempo queda. [Probar la experiencia] configurando un botón con variables dinámicas y observe cómo su superficie de control se convierte en un monitor de confianza en miniatura. La arquitectura de comunicación entre Companion y Timers Studio utiliza dos canales. Las acciones salientes viajan a través de la API REST, autenticadas con un token Bearer que el usuario genera en el panel API and Integrations del dashboard de Timers Studio. Cada clave API tiene scopes configurables: READ para monitorización, TRANSPORT para control de timer, MUTATION para modificación de datos y ADMIN para acceso completo. La configuración del módulo Companion solicita la clave API y determina automáticamente qué acciones están disponibles según los scopes de la clave. Las actualizaciones de estado entrantes viajan a través de Server-Sent Events. Cuando el módulo se conecta, abre un stream SSE que recibe cada cambio de estado conforme ocurre. Timer iniciado, timer pausado, mensaje enviado, tema cambiado, blackout alternado: cada evento llega como un payload JSON estructurado que el módulo analiza y dirige a los manejadores apropiados de feedback y variables. Esta arquitectura significa que el módulo no necesita sondear la API. Escucha, y el servidor le indica qué cambió, como un bus de intercom en una sala de control profesional. La pregunta práctica que los equipos de producción formulan es cuándo usar Companion en lugar de la integración WebHID nativa. La respuesta es arquitectónica. Si el Stream Deck solo necesita controlar Timers Studio, WebHID nativo proporciona latencia más rápida, configuración más simple y menos dependencias. Si el Stream Deck necesita controlar Timers Studio junto a vMix, OBS, ProPresenter, una consola de iluminación o cualquier otro sistema de la pila de producción, Companion es la elección correcta porque puede mapear una sola pulsación de botón a acciones sincronizadas en todos esos sistemas. Una configuración común en entornos broadcast coloca Companion en un mini-PC dedicado o portátil que actúa como hub de control. El Stream Deck se conecta a esta máquina por USB. Companion se comunica con Timers Studio a través de la API REST, con vMix a través de su API TCP, con OBS a través de su API WebSocket, y con la consola de iluminación a través de Art-Net o sACN. El operador pulsa un botón y el timer se inicia, la cámara cambia a la entrada principal, el rótulo inferior aparece y las luces del escenario transicionan al preset de presentación. Esa única pulsación dispara toda la escaleta de la transición. Ese tipo de control sincronizado entre sistemas es para lo que Companion fue construido. [Ver la consola en acción] y descubra cómo una sola pulsación puede orquestar toda su cadena de producción. La instalación del módulo es directa. En la interfaz de Companion, busque "Timers Studio" en la biblioteca de módulos, instálelo e introduzca su URL del studio y clave API. Companion se conectará, verificará los scopes de la clave y poblará las acciones, feedbacks y variables disponibles. Desde ahí, arrastre acciones a los botones, asigne feedbacks para estado visual y configure variables para etiquetas dinámicas. Una página completa de botones para Timers Studio puede configurarse en menos de diez minutos. Para equipos de producción que operan a escala, gestionando múltiples espectáculos por semana en diferentes recintos y clientes, Companion proporciona una capa de consistencia. Puede guardar su configuración de Companion como un archivo y cargarla en cada recinto. El diseño de botones permanece igual. Los mapeos de acciones permanecen iguales. Solo la clave API y la URL del studio cambian entre espectáculos. Esta previsibilidad tiene valor operacional en entornos donde el tiempo de montaje es limitado y el equipo de producción necesita confiar en que su memoria muscular funcionará correctamente. [Lanzar tu primer estudio] y genere una clave API para explorar el módulo. El módulo Companion está disponible en la biblioteca de módulos de Bitfocus Companion y recibe actualizaciones periódicas conforme se añaden nuevas funcionalidades a la plataforma.