Bitfocus Companion
Cliqer se integra con Bitfocus Companion, el popular software de código abierto de control por botones para producción en directo. El módulo de Cliqer se instala automáticamente cuando Cliqer detecta Companion en tu sistema, así que no hay que configurar nada a mano.
Cómo funciona
Cliqer ejecuta dos servidores de loopback a los que se conecta el módulo: una API HTTP de acciones en 127.0.0.1:24601 para las acciones de los botones, y un WebSocket en 127.0.0.1:9052 que transmite en tiempo real las actualizaciones del temporizador y el estado de la app para los feedbacks y las variables.
Configuración
Instala Companion
Instala Bitfocus Companion y ábrelo al menos una vez
Inicia Cliqer
Inicia Cliqer: colocará el módulo de Cliqer en la carpeta de módulos de Companion
Añade una conexión de Cliqer
Reinicia Companion una vez para que detecte el módulo y, después, añade una conexión Cliqer (apunta a 127.0.0.1, puerto de la API de acciones 24601)
Acciones disponibles
El módulo ofrece 19 acciones, agrupadas por categoría:
| Categoría | Acciones |
|---|---|
| Click | Left Click, Right Click |
| Timer | Start / Pause Timer, Reset Timer, +1 / +2 / +5 Minutes, −1 / −2 / −5 Minutes |
| Presets | Timer Preset 1 / 2 / 3 / 4 (5, 10, 15, 20 minutos) |
| Callers | Caller to Program (elige el llamante 1-9), Clear Program (corte a negro) |
| Control | Stop Screen Share, Toggle Program NDI Output, Toggle Timer NDI Output |
Feedbacks
Los feedbacks cambian el aspecto de un botón según el estado en tiempo real. El módulo define 11 feedbacks:
| Feedback | Verdadero cuando |
|---|---|
| Timer Running | El temporizador está contando |
| Timer Stopped | El temporizador está en pausa |
| Timer Green (Talk Phase) | El temporizador está en marcha con tiempo de sobra |
| Timer Overtime | El temporizador ha pasado de 0:00 en modo cuenta atrás |
| Timer Yellow (Warning Phase) | El temporizador se acerca a su límite o está en pausa |
| Timer Red Flash (At Zero / Overtime) | Parpadea cuando el temporizador llega a cero / entra en tiempo extra |
| Caller On Air (Program) | El llamante seleccionado está en antena en el bus de programa |
| Caller Connected | La posición de llamante seleccionada tiene un llamante conectado |
| Screen Share Active | Hay una pantalla compartida en la señal de programa |
| Program NDI Output Active | La salida NDI de programa está activada |
| Timer NDI Output Active | La salida NDI del temporizador está activada |
Variables
El módulo expone 14 variables para usar en el texto de los botones y en los triggers. Haz referencia a ellas mediante la etiqueta de la conexión, por ejemplo $(Cliqer:timer_display) cuando la conexión se llama Cliqer:
| Variable | Descripción | Ejemplo |
|---|---|---|
timer_display | Valor actual del temporizador (MM:SS) | 14:30 |
timer_minutes | Componente de minutos | 14 |
timer_seconds | Componente de segundos | 30 |
timer_state | Estado del temporizador | running / stopped |
preset1_label … preset4_label | Duraciones de los presets (MM:SS) | 05:00 |
program_caller | Nombre del llamante que está en programa | Jane |
callers_count | Llamantes conectados | 3 |
viewers_count | Público / espectadores | 128 |
presenters_count | Presentadores conectados | 2 |
room_id | ID de la sala actual | ABC123 |
room_url | Enlace de la sala para compartir | https://cliqer.io/ABC123 |
Presets
El módulo incluye presets de botones listos para usar, para que puedas montar una superficie de control arrastrándolos, agrupados en las mismas categorías que las acciones: Click, Timer, Presets, Callers y Control. Suéltalos en una página de Companion para controlar al instante diapositivas, temporizador, llamantes y salidas.
Compatibilidad con plataformas
| Plataforma | Ubicación de la instalación automática |
|---|---|
| macOS | ~/Library/Application Support/companion/modules/ |
| Windows | %APPDATA%\companion\modules\ |
El módulo se coloca en una carpeta cliqer-cliqer-<version> dentro de ese directorio (por ejemplo cliqer-cliqer-1.2.2). Cuando Cliqer instala una actualización, primero elimina la carpeta de la versión anterior, de modo que solo queda la versión actual.
Solución de problemas
El módulo no aparece en Companion
- Asegúrate de que Companion está instalado y de que lo has abierto al menos una vez antes que Cliqer
- Companion solo examina su carpeta de módulos al arrancar, así que reinicia Companion una vez después del primer inicio de Cliqer y aparecerá el tipo de conexión Cliqer
- El botón Refresh modules de Companion actualiza su tienda online, no la carpeta local de módulos, así que reinicia Companion para que aparezca un módulo recién instalado
Las acciones no se disparan
- Comprueba que la conexión apunta a
127.0.0.1en el puerto de la API de acciones24601 - Mantén el puerto predeterminado del módulo: Cliqer sirve la API de acciones en
24601 - Solo una instancia de Cliqer puede ocupar los puertos locales de un equipo; consulta las notas sobre Stream Deck
Los feedbacks o las variables del temporizador no se actualizan
- La señal en tiempo real del temporizador y del estado de la app usa el WebSocket de loopback en el puerto
9052, así que Companion debe ejecutarse en el mismo ordenador que Cliqer - Las acciones de diapositivas y del temporizador pueden funcionar por HTTP aunque la señal no esté conectada, así que, si los botones se disparan pero los feedbacks no cambian, comprueba el estado de la conexión en Companion
Ver también: Integración con Stream Deck · Timer