Bitfocus Companion
Cliqer si integra con Bitfocus Companion, il popolare software open source per il controllo tramite pulsanti nella produzione live. Il modulo Cliqer viene installato automaticamente quando Cliqer rileva Companion sul tuo sistema, quindi non serve alcuna configurazione manuale.
Come funziona
Cliqer esegue due server di loopback a cui si collega il modulo: un'API HTTP per le azioni su 127.0.0.1:24601 per le azioni dei pulsanti e un WebSocket su 127.0.0.1:9052 che trasmette in tempo reale gli aggiornamenti del timer e lo stato dell'app per feedback e variabili.
Configurazione
Installa Companion
Installa Bitfocus Companion e avvialo almeno una volta
Avvia Cliqer
Avvia Cliqer: copierà il modulo Cliqer nella cartella dei moduli di Companion
Aggiungi una connessione Cliqer
Riavvia Companion una volta affinché rilevi il modulo, quindi aggiungi una connessione Cliqer (punta a 127.0.0.1, porta dell'API delle azioni 24601)
Azioni disponibili
Il modulo offre 19 azioni, raggruppate per categoria:
| Categoria | Azioni |
|---|---|
| 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 minuti) |
| Callers | Caller to Program (scegli l'ospite remoto 1-9), Clear Program (stacco al nero) |
| Control | Stop Screen Share, Toggle Program NDI Output, Toggle Timer NDI Output |
Feedback
I feedback cambiano l'aspetto di un pulsante in base allo stato in tempo reale. Il modulo definisce 11 feedback:
| Feedback | Attivo quando |
|---|---|
| Timer Running | Il timer sta contando |
| Timer Stopped | Il timer è in pausa |
| Timer Green (Talk Phase) | Il timer è in corso e c'è ancora tempo a disposizione |
| Timer Overtime | Il timer ha superato 0:00 in modalità conto alla rovescia |
| Timer Yellow (Warning Phase) | Il timer si avvicina al limite, oppure è in pausa |
| Timer Red Flash (At Zero / Overtime) | Lampeggia quando il timer arriva a zero / sfora il tempo |
| Caller On Air (Program) | L'ospite remoto selezionato è in onda sul bus program |
| Caller Connected | Lo slot selezionato ha un ospite remoto collegato |
| Screen Share Active | Una condivisione dello schermo è sul segnale program |
| Program NDI Output Active | L'uscita NDI del program è attiva |
| Timer NDI Output Active | L'uscita NDI del timer è attiva |
Variabili
Il modulo espone 14 variabili da usare nel testo dei pulsanti e nei trigger. Richiamale tramite l'etichetta della connessione, ad esempio $(Cliqer:timer_display) quando la connessione si chiama Cliqer:
| Variabile | Descrizione | Esempio |
|---|---|---|
timer_display | Valore attuale del timer (MM:SS) | 14:30 |
timer_minutes | Componente dei minuti | 14 |
timer_seconds | Componente dei secondi | 30 |
timer_state | Stato del timer | running / stopped |
preset1_label … preset4_label | Durate dei preset (MM:SS) | 05:00 |
program_caller | Nome dell'ospite remoto attualmente in program | Jane |
callers_count | Ospiti remoti collegati | 3 |
viewers_count | Pubblico / spettatori | 128 |
presenters_count | Relatori collegati | 2 |
room_id | ID della stanza attuale | ABC123 |
room_url | Link condivisibile della stanza | https://cliqer.io/ABC123 |
Preset
Il modulo include preset di pulsanti già pronti, così puoi creare una superficie di controllo semplicemente trascinandoli, raggruppati nelle stesse categorie delle azioni: Click, Timer, Presets, Callers e Control. Trascinali su una pagina di Companion per controllare all'istante slide, timer, ospiti remoti e uscite.
Piattaforme supportate
| Piattaforma | Percorso di installazione automatica |
|---|---|
| macOS | ~/Library/Application Support/companion/modules/ |
| Windows | %APPDATA%\companion\modules\ |
Il modulo viene copiato in una cartella cliqer-cliqer-<version> all'interno di quella directory (ad esempio cliqer-cliqer-1.2.2). Quando Cliqer installa un aggiornamento, rimuove prima la cartella della versione precedente, così resta solo la versione attuale.
Risoluzione dei problemi
Il modulo non compare in Companion
- Assicurati che Companion sia installato e sia stato avviato almeno una volta prima di Cliqer
- Companion analizza la cartella dei moduli solo all'avvio, quindi riavvia Companion una volta dopo il primo avvio di Cliqer e comparirà il tipo di connessione Cliqer
- Il pulsante Refresh modules di Companion aggiorna il suo store online, non la cartella locale dei moduli, quindi riavvia Companion per far comparire un modulo appena installato
Le azioni non vengono eseguite
- Verifica che la connessione punti a
127.0.0.1sulla porta dell'API delle azioni24601 - Mantieni la porta predefinita del modulo: Cliqer espone l'API delle azioni su
24601 - Su un computer solo un'istanza di Cliqer può occupare le porte locali: consulta le note su Stream Deck
I feedback o le variabili del timer non si aggiornano
- Il flusso in tempo reale del timer e dello stato dell'app usa il WebSocket di loopback sulla porta
9052, quindi Companion deve essere eseguito sullo stesso computer di Cliqer - Le azioni su slide e timer possono comunque andare a buon fine via HTTP anche quando il flusso non è connesso: se i pulsanti funzionano ma i feedback restano statici, controlla lo stato della connessione in Companion
Vedi anche: Integrazione con Stream Deck · Timer