Bitfocus Companion

Ελέγξτε το Cliqer από το Bitfocus Companion με το ενσωματωμένο module του Cliqer, που εγκαθίσταται αυτόματα και είναι έτοιμο για χρήση.

Έλεγχος του Cliqer από επιφάνειες ελέγχου του Bitfocus Companion

Το Cliqer ενσωματώνεται με το Bitfocus Companion, το δημοφιλές λογισμικό ανοιχτού κώδικα για έλεγχο μέσω πλήκτρων σε ζωντανές παραγωγές. Το module του Cliqer εγκαθίσταται αυτόματα όταν το Cliqer εντοπίσει το Companion στο σύστημά σας, οπότε δεν απαιτείται καμία χειροκίνητη ρύθμιση.

Αυτόματη εγκατάσταση: Το module του Cliqer συνοδεύει την εφαρμογή και τοποθετείται στον φάκελο modules του Companion κατά την εκκίνηση. Όταν κυκλοφορεί νεότερη έκδοση, η εφαρμογή το ενημερώνει επιτόπου.

Διαθεσιμότητα: Το module (v1.2.2) διατίθεται μαζί με την εφαρμογή Cliqer για υπολογιστή.

Πώς λειτουργεί

Το Cliqer εκτελεί δύο διακομιστές loopback στους οποίους συνδέεται το module: ένα HTTP API ενεργειών στο 127.0.0.1:24601 για τις ενέργειες των πλήκτρων και ένα WebSocket στο 127.0.0.1:9052 που μεταδίδει ζωντανά τις ενημερώσεις του χρονομέτρου και την κατάσταση της εφαρμογής για τα feedbacks και τις μεταβλητές.

Ίδιος υπολογιστής: Και οι δύο διακομιστές δέχονται μόνο συνδέσεις loopback, επομένως το Companion πρέπει να εκτελείται στον ίδιο υπολογιστή με το Cliqer για να εκτελούνται οι ενέργειες και να ενημερώνονται τα feedbacks.

Ρύθμιση

Εγκατάσταση του Companion

Εγκαταστήστε το Bitfocus Companion και εκκινήστε το τουλάχιστον μία φορά

Εκκίνηση του Cliqer

Εκκινήστε το Cliqer: τοποθετεί το module του Cliqer στον φάκελο modules του Companion

Προσθήκη σύνδεσης Cliqer

Επανεκκινήστε το Companion μία φορά ώστε να εντοπίσει το module και, στη συνέχεια, προσθέστε μια σύνδεση Cliqer (δείχνει στο 127.0.0.1, θύρα API ενεργειών 24601)

Αυτόματες ενημερώσεις: Σε κάθε εκκίνηση, το Cliqer ελέγχει αν περιλαμβάνει νεότερη έκδοση του module και ενημερώνει επιτόπου τον φάκελο modules. Αν το Companion κρατά ανοιχτό το τρέχον module, η ανανέωση αναβάλλεται για επόμενη εκκίνηση αντί να μείνει μισογραμμένη.

Διαθέσιμες ενέργειες

Το module παρέχει 19 ενέργειες, ομαδοποιημένες ανά κατηγορία:

Κατηγορία	Ενέργειες
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 λεπτά)
Callers	Caller to Program (επιλογή καλούντος 1-9), Clear Program (μετάβαση σε μαύρο)
Control	Stop Screen Share, Toggle Program NDI Output, Toggle Timer NDI Output

Πώς λειτουργούν τα presets: Οι τέσσερις ενέργειες presets στέλνουν σταθερές διάρκειες 5, 10, 15 και 20 λεπτών. Το Cliqer επιλέγει το αντίστοιχο preset στον πίνακα Timer όταν έχει ρυθμιστεί ένα για τον συγκεκριμένο αριθμό λεπτών, διαφορετικά ρυθμίζει το χρονόμετρο απευθείας σε αυτή τη διάρκεια.

Οι ενέργειες καλούντων, κοινής χρήσης οθόνης και NDI εκτελούνται στον υπολογιστή που φιλοξενεί την παρουσίαση. Η μεταφορά καλούντος στο program, ο καθαρισμός του program, η διακοπή κοινής χρήσης και οι εναλλαγές NDI εκτελούνται στην εφαρμογή Cliqer αυτού του υπολογιστή, ενώ οι ενέργειες καλούντων απαιτούν συνδρομή με έλεγχο Studio. Μια ενέργεια χωρίς αντικείμενο επιστρέφει επιτυχία και δεν κάνει τίποτα.

Feedbacks

Τα feedbacks αλλάζουν την εμφάνιση ενός πλήκτρου ανάλογα με τη ζωντανή κατάσταση. Το module ορίζει 11 feedbacks:

Feedback	Αληθές όταν
Timer Running	Το χρονόμετρο μετρά ενεργά
Timer Stopped	Το χρονόμετρο βρίσκεται σε παύση
Timer Green (Talk Phase)	Το χρονόμετρο τρέχει και υπάρχει άνετος χρόνος
Timer Overtime	Το χρονόμετρο έχει περάσει το 0:00 σε λειτουργία αντίστροφης μέτρησης
Timer Yellow (Warning Phase)	Το χρονόμετρο πλησιάζει το όριό του ή βρίσκεται σε παύση
Timer Red Flash (At Zero / Overtime)	Αναβοσβήνει όταν το χρονόμετρο φτάνει στο μηδέν / μπαίνει σε υπέρβαση χρόνου
Caller On Air (Program)	Ο επιλεγμένος καλών είναι on air στον δίαυλο program
Caller Connected	Στην επιλεγμένη θέση καλούντος υπάρχει συνδεδεμένος καλών
Screen Share Active	Μια κοινή χρήση οθόνης βρίσκεται στο σήμα program
Program NDI Output Active	Η έξοδος NDI του program είναι ενεργή
Timer NDI Output Active	Η έξοδος NDI του χρονομέτρου είναι ενεργή

Μεταβλητές

Το module παρέχει 14 μεταβλητές για χρήση στο κείμενο των πλήκτρων και στα triggers. Αναφερθείτε σε αυτές μέσω της ετικέτας της σύνδεσης, για παράδειγμα $(Cliqer:timer_display) όταν η σύνδεση ονομάζεται Cliqer:

Μεταβλητή	Περιγραφή	Παράδειγμα
`timer_display`	Τρέχουσα τιμή χρονομέτρου (MM:SS)	`14:30`
`timer_minutes`	Λεπτά	`14`
`timer_seconds`	Δευτερόλεπτα	`30`
`timer_state`	Κατάσταση χρονομέτρου	`running` / `stopped`
`preset1_label` … `preset4_label`	Διάρκειες presets (MM:SS)	`05:00`
`program_caller`	Όνομα του καλούντος που βρίσκεται αυτή τη στιγμή στο program	`Jane`
`callers_count`	Συνδεδεμένοι καλούντες	`3`
`viewers_count`	Κοινό / θεατές	`128`
`presenters_count`	Συνδεδεμένοι ομιλητές	`2`
`room_id`	Αναγνωριστικό τρέχοντος δωματίου	`ABC123`
`room_url`	Σύνδεσμος δωματίου για κοινοποίηση	`https://cliqer.io/ABC123`

Presets

Το module περιλαμβάνει έτοιμα presets πλήκτρων ώστε να δημιουργείτε μια επιφάνεια ελέγχου με απλή μεταφορά, ομαδοποιημένα στις ίδιες κατηγορίες με τις ενέργειες: Click, Timer, Presets, Callers και Control. Τοποθετήστε τα σε μια σελίδα του Companion για άμεσο έλεγχο διαφανειών, χρονομέτρου, καλούντων και εξόδων.

Υποστηριζόμενες πλατφόρμες

Πλατφόρμα	Θέση αυτόματης εγκατάστασης
macOS	`~/Library/Application Support/companion/modules/`
Windows	`%APPDATA%\companion\modules\`

Το module τοποθετείται σε φάκελο cliqer-cliqer-<version> μέσα σε αυτόν τον κατάλογο (για παράδειγμα cliqer-cliqer-1.2.2). Όταν το Cliqer εγκαθιστά μια ενημέρωση, αφαιρεί πρώτα τον φάκελο της προηγούμενης έκδοσης, ώστε να παραμένει μόνο η τρέχουσα έκδοση.

Αντιμετώπιση προβλημάτων

Το module δεν εμφανίζεται στο Companion

Βεβαιωθείτε ότι το Companion είναι εγκατεστημένο και έχει εκκινηθεί τουλάχιστον μία φορά πριν από το Cliqer
Το Companion σαρώνει τον φάκελο modules μόνο κατά την εκκίνηση, επομένως επανεκκινήστε το Companion μία φορά μετά την πρώτη εκκίνηση του Cliqer και θα εμφανιστεί ο τύπος σύνδεσης Cliqer
Το κουμπί Refresh modules του Companion ανανεώνει το online κατάστημά του, όχι τον τοπικό φάκελο modules, επομένως επανεκκινήστε το Companion για να εμφανιστεί ένα module που μόλις εγκαταστάθηκε

Οι ενέργειες δεν εκτελούνται

Επιβεβαιώστε ότι η σύνδεση στοχεύει στο 127.0.0.1 στη θύρα API ενεργειών 24601
Διατηρήστε την προεπιλεγμένη θύρα του module: το Cliqer εξυπηρετεί το API ενεργειών στη 24601
Μόνο μία παρουσία του Cliqer μπορεί να δεσμεύει τις τοπικές θύρες σε έναν υπολογιστή, δείτε τις σημειώσεις για το Stream Deck

Τα feedbacks ή οι μεταβλητές του χρονομέτρου δεν ενημερώνονται

Η ζωντανή ροή χρονομέτρου και κατάστασης εφαρμογής χρησιμοποιεί το loopback WebSocket στη θύρα 9052, επομένως το Companion πρέπει να εκτελείται στον ίδιο υπολογιστή με το Cliqer
Οι ενέργειες διαφανειών και χρονομέτρου μπορούν να επιτυγχάνουν μέσω HTTP ακόμη και όταν η ροή δεν είναι συνδεδεμένη, οπότε αν τα πλήκτρα λειτουργούν αλλά τα feedbacks μένουν στατικά, ελέγξτε την κατάσταση της σύνδεσης στο Companion

Δείτε επίσης: Ενσωμάτωση Stream Deck · Timer

Elgato Stream Deck

Ελέγξτε το Cliqer με ένα Elgato Stream Deck μέσω του ενσωματωμένου πρόσθετου Elgato Stream Deck.

Επισκόπηση API

Πλήρης τεκμηρίωση API για ενοποίηση με το Cliqer