Bitfocus Companion
Cliqer integruje się z Bitfocus Companion, popularnym oprogramowaniem open source do sterowania przyciskami w produkcji na żywo. Moduł Cliqer jest instalowany automatycznie, gdy Cliqer wykryje Companion w Twoim systemie, więc nie musisz niczego konfigurować ręcznie.
Jak to działa
Cliqer uruchamia dwa serwery loopback, z którymi łączy się moduł: API akcji HTTP na 127.0.0.1:24601 do obsługi akcji przycisków oraz WebSocket na 127.0.0.1:9052, który na bieżąco przesyła aktualizacje timera i stan aplikacji na potrzeby feedbacków i zmiennych.
Konfiguracja
Zainstaluj Companion
Zainstaluj Bitfocus Companion i uruchom go co najmniej raz
Uruchom Cliqer
Uruchom Cliqer: umieści on moduł Cliqer w folderze modułów Companion
Dodaj połączenie Cliqer
Uruchom ponownie Companion, aby wczytał moduł, a następnie dodaj połączenie Cliqer (wskazuje na 127.0.0.1, port API akcji 24601)
Dostępne akcje
Moduł udostępnia 19 akcji pogrupowanych według kategorii:
| Kategoria | Akcje |
|---|---|
| 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 minut) |
| Callers | Caller to Program (wybór rozmówcy 1-9), Clear Program (przejście do czerni) |
| Control | Stop Screen Share, Toggle Program NDI Output, Toggle Timer NDI Output |
Feedbacki
Feedbacki zmieniają wygląd przycisku na podstawie bieżącego stanu. Moduł definiuje 11 feedbacków:
| Feedback | Aktywny, gdy |
|---|---|
| Timer Running | Timer aktywnie odlicza czas |
| Timer Stopped | Timer jest wstrzymany |
| Timer Green (Talk Phase) | Timer działa i zostało jeszcze sporo czasu |
| Timer Overtime | Timer w trybie odliczania przekroczył 0:00 |
| Timer Yellow (Warning Phase) | Timer zbliża się do limitu lub jest wstrzymany |
| Timer Red Flash (At Zero / Overtime) | Miga, gdy timer dochodzi do zera / przekracza czas |
| Caller On Air (Program) | Wybrany rozmówca jest na żywo na szynie programu |
| Caller Connected | W wybranym slocie rozmówcy jest połączony rozmówca |
| Screen Share Active | Udostępniany ekran jest na sygnale programu |
| Program NDI Output Active | Wyjście NDI programu jest włączone |
| Timer NDI Output Active | Wyjście NDI timera jest włączone |
Zmienne
Moduł udostępnia 14 zmiennych do użycia w tekście przycisków i wyzwalaczach. Odwołuj się do nich przez etykietę połączenia, na przykład $(Cliqer:timer_display), gdy połączenie nazywa się Cliqer:
| Zmienna | Opis | Przykład |
|---|---|---|
timer_display | Bieżąca wartość timera (MM:SS) | 14:30 |
timer_minutes | Minuty | 14 |
timer_seconds | Sekundy | 30 |
timer_state | Stan timera | running / stopped |
preset1_label … preset4_label | Czasy trwania presetów (MM:SS) | 05:00 |
program_caller | Imię rozmówcy, który jest obecnie na programie | Jane |
callers_count | Połączeni rozmówcy | 3 |
viewers_count | Publiczność / widzowie | 128 |
presenters_count | Połączeni prezenterzy | 2 |
room_id | ID bieżącego pokoju | ABC123 |
room_url | Link do pokoju do udostępnienia | https://cliqer.io/ABC123 |
Presety
Moduł zawiera gotowe presety przycisków, dzięki którym zbudujesz powierzchnię sterującą metodą przeciągnij i upuść. Są pogrupowane w tych samych kategoriach co akcje: Click, Timer, Presets, Callers i Control. Upuść je na stronę Companion, aby od razu sterować slajdami, timerem, rozmówcami i wyjściami.
Obsługiwane platformy
| Platforma | Lokalizacja automatycznej instalacji |
|---|---|
| macOS | ~/Library/Application Support/companion/modules/ |
| Windows | %APPDATA%\companion\modules\ |
Moduł jest umieszczany w folderze cliqer-cliqer-<version> w tym katalogu (na przykład cliqer-cliqer-1.2.2). Gdy Cliqer instaluje aktualizację, najpierw usuwa folder poprzedniej wersji, więc zostaje tylko bieżąca wersja.
Rozwiązywanie problemów
Moduł nie pojawia się w Companion
- Upewnij się, że Companion jest zainstalowany i został uruchomiony co najmniej raz przed Cliqerem
- Companion skanuje folder modułów tylko przy starcie, więc po pierwszym uruchomieniu Cliqera uruchom ponownie Companion, a pojawi się typ połączenia Cliqer
- Przycisk Refresh modules w Companion odświeża jego sklep online, a nie lokalny folder modułów, więc aby zobaczyć świeżo zainstalowany moduł, uruchom ponownie Companion
Akcje nie są wykonywane
- Sprawdź, czy połączenie wskazuje na
127.0.0.1i port API akcji24601 - Zachowaj domyślny port modułu: Cliqer udostępnia API akcji na porcie
24601 - Lokalne porty na danym komputerze może zajmować tylko jedna instancja Cliqera, zobacz uwagi dotyczące Stream Deck
Feedbacki timera lub zmienne się nie aktualizują
- Strumień bieżącego timera i stanu aplikacji korzysta z WebSocketu loopback na porcie
9052, więc Companion musi działać na tym samym komputerze co Cliqer - Akcje slajdów i timera mogą nadal działać przez HTTP, nawet gdy strumień nie jest połączony, więc jeśli przyciski działają, a feedbacki się nie zmieniają, sprawdź stan połączenia w Companion
Zobacz też: Integracja ze Stream Deck · Timer