Το BoothDock Studio μπορεί να ενημερώνει άλλα προγράμματα για κάθε βήμα μιας συνεδρίας (Webhooks) και να ελέγχεται το ίδιο από άλλα προγράμματα (τοπικό API). Και τα δύο τα βρίσκεις στην περιοχή διαχείρισης κάτω από Σύστημα → Αυτοματισμός.
Στο BoothDock Studio 1.4.0 και σε παλαιότερες εκδόσεις τα webhooks εκεί ονομάζονται ακόμη «Εναύσματα».
Τα webhooks υπάρχουν σε Windows και από την έκδοση 1.5.10 και σε iPad, iPhone και Mac. Το τοπικό API υπάρχει από την έκδοση 1.4.0 και σε iPad, iPhone και Mac, η εξαγωγή σε πραγματικό χρόνο από την έκδοση 1.5.2.
Τυπικές χρήσεις: φωτισμός ή DMX σε συγχρονισμό με την αντίστροφη μέτρηση, ένα overlay για stream, ένας μετρητής στην είσοδο – ή ένα Stream Deck ως τηλεχειριστήριο για το Box.

Ρύθμιση webhooks
Συμπλήρωσε το πεδίο Διεύθυνση (URL), σε Windows και το πεδίο Πρόγραμμα – ή και τα δύο. Σε κάθε συμβάν το Box καλεί ό,τι έχεις συμπληρώσει:
- Πρόγραμμα (μόνο Windows) – ένα
.exe,.batή.cmd. Κλήση:πρόγραμμα <συμβάν> <param1> <param2> …. Κάθε τιμή φτάνει ως ξεχωριστό όρισμα, ακόμη κι αν περιέχει κενά. Το πρόγραμμα ξεκινά χωρίς παράθυρο, στον δικό του φάκελο. Ένα σενάριο PowerShell (.ps1) το ξεκινάς μέσω ενός μικρού.batπου μπαίνει μπροστά του. - Διεύθυνση (URL) –
httpήhttps, καλείται με GET:https://ο-διακομιστής-σου/hook?event_type=<συμβάν>¶m1=…¶m2=…. Οι τιμές είναι κωδικοποιημένες για URL· παράμετροι που υπάρχουν ήδη στη διεύθυνσή σου διατηρούνται.
Σε iPad, iPhone και Mac υπάρχει μόνο η διεύθυνση. Εκεί το http:// λειτουργεί μόνο στο τοπικό δίκτυο (διεύθυνση IP ή .local) – άρα Shelly, WLED και Tasmota στο Wi-Fi λειτουργούν. Οι διευθύνσεις στο διαδίκτυο χρειάζονται https://.
Η συνεδρία δεν περιμένει ποτέ τα webhooks σου: το πρόγραμμα και η κλήση τρέχουν παράλληλα, και μια κλήση μπορεί να διαρκέσει το πολύ 5 δευτερόλεπτα. Η Αποστολή δοκιμής στέλνει αμέσως ένα session_start – έτσι ελέγχεις τη σύνδεση χωρίς να ξεκινήσεις συνεδρία.
Πρόγραμμα και διεύθυνση ρυθμίζονται μόνο απευθείας στο Box, όχι μέσω του Hub: μια διαδρομή προγράμματος είναι δικαίωμα εκτέλεσης κάποιου πράγματος στον υπολογιστή.
Ξεχωριστή διεύθυνση ανά συμβάν
Από την έκδοση 1.5.10 μπορείς στο Ξεχωριστή διεύθυνση ανά συμβάν (προαιρετικό) να δώσεις επιπλέον σε κάθε συμβάν τη δική του διεύθυνση – για παράδειγμα για μια πρίζα Shelly, WLED ή Tasmota στο Wi-Fi που ανάβει στην αντίστροφη μέτρηση ή στη λήψη. Παράδειγμα για το countdown_start: http://192.168.1.50/relay/0?turn=on.
Το Box καλεί αυτή τη διεύθυνση επιπλέον του προγράμματος και της διεύθυνσης παραπάνω, ως απλό GET χωρίς πρόσθετες τιμές. Η προηγούμενη διεύθυνση και τα υπάρχοντα σενάρια συνεχίζουν να λειτουργούν αμετάβλητα. Το countdown έρχεται κάθε δευτερόλεπτο· στο file_upload το Box καλεί τη δική του διεύθυνση μία φορά ανά συνεδρία (τη γενική διεύθυνση όπως πριν ανά αρχείο).
Συμβάντα
| Συμβάν | Πότε | Παράμετροι |
|---|---|---|
session_start | Ένας επισκέπτης ξεκινά συνεδρία, η λειτουργία έχει καθοριστεί | 1: λειτουργία (PrintOnly, PrintAndGIF, OnlyGIF, SlowMoOr360, Video), 2: λειτουργία BoothDock (photo, gif, boomerang, video, slowmo, ai) |
countdown_start | Ξεκινά η αντίστροφη μέτρηση | 1: δευτερόλεπτα |
countdown | Κάθε δευτερόλεπτο της αντίστροφης μέτρησης | 1: πρόοδος σε ποσοστό (από 0) |
capture_start | Η αντίστροφη μέτρηση τελείωσε, ξεκινά η λήψη | – |
file_download | Η κάμερα αποθήκευσε μια φωτογραφία | 1: όνομα αρχείου, 2: πλήρης διαδρομή |
processing_start | Ξεκινά η επεξεργασία | ένα όνομα αρχείου για κάθε πρωτότυπο της κάμερας, ως τελευταία τιμή το αρχείο εκτύπωσης (προς το παρόν κενό) |
sharing_screen | Εμφανίζεται η οθόνη αποτελέσματος (μία φορά ανά συνεδρία) | – |
printing | Ένα φύλλο στέλνεται σε εκτυπωτή | 1: αρχείο (προς το παρόν κενό), 2: αντίτυπα, 3: εκτυπωτής |
file_upload | Ένα αρχείο έφτασε στο Hub (ανά αρχείο) | 1: διαδρομή στο Box, 2: σύνδεσμος γκαλερί, 3: τύπος (print, photo, original, animation, boomerang, video), 4: άλμπουμ (όνομα εκδήλωσης) |
lead_submitted | Ένας καλεσμένος έστειλε τη φόρμα Δεδομένα καλεσμένων (φόρμα) (από 1.5.0) | – (οι ίδιες οι απαντήσεις υπάρχουν μόνο στην εξαγωγή CSV) |
session_end | Η συνεδρία τελειώνει – ολοκληρώθηκε, ακυρώθηκε, έληξε ή διαγράφηκε | – |
Παράδειγμα ενός .bat που καταγράφει κάθε συμβάν: echo %DATE% %TIME% %* >> "%~dp0events.log"
Τοπικό API
Άλλα προγράμματα ελέγχουν το Box μέσω HTTP – για παράδειγμα ένα Stream Deck, ένα δικό σου σενάριο ή ένας χειρισμός 360° από το κινητό.
- Ενεργοποίηση: Σύστημα → Αυτοματισμός → Ενεργοποίηση API. Από προεπιλογή το API είναι ανενεργό. Θύρα 1500, μπορεί να αλλάξει.
- Διεύθυνση:
http://localhost:1500/api/<εντολή>(ή127.0.0.1). Από προεπιλογή το Box δέχεται αιτήματα μόνο από αυτόν τον υπολογιστή. - Κωδικός: 16 χαρακτήρες, εμφανίζεται στην ίδια ενότητα – αντίγραψέ τον ή δημιούργησε νέο. Δίνεται ως
?password=…, ως κεφαλίδαX-Api-Passwordή ωςAuthorization: Bearer …. Μόνο τοpingλειτουργεί χωρίς αυτόν. - Απάντηση: πάντα HTTP 200 με JSON, για παράδειγμα
{"ApiVersion":1,"Command":"cancel","IsSuccessful":true,"ErrorMessage":""}. Αν πέτυχε, το δείχνει τοIsSuccessful· σε περίπτωση σφάλματος ο λόγος βρίσκεται στοErrorMessage. Ορισμένες εντολές επιστρέφουν επιπλέονData.
Μια πλήρης κλήση: http://localhost:1500/api/start?mode=print&password=Ο-ΚΩΔΙΚΟΣ-ΣΟΥ
Έλεγχος από το δίκτυο (κινητό, tablet, 360°)
Ενεργοποίησε επιπλέον το Προσβάσιμο και από το δίκτυο. Τότε το Box δέχεται αιτήματα από συσκευές στο ίδιο Wi-Fi/LAN – ποτέ από το διαδίκτυο.
- Διεύθυνση για το κινητό: εμφανίζεται στη γραμμή κατάστασης, για παράδειγμα
http://192.168.1.20:1500. Το παράδειγμα από κάτω δείχνει τότε αμέσως τη σωστή διεύθυνση. - Χωρίς πληκτρολόγηση IP: Το Box δηλώνει μόνο του την παρουσία του στο δίκτυο (mDNS/Bonjour, τύπος υπηρεσίας
_boothdock._tcp, όνομα «BoothDock» συν το όνομα του υπολογιστή). Οι εφαρμογές που το αναζητούν το βρίσκουν αυτόματα. - Φραγή: Αν μια συσκευή στείλει δέκα φορές μέσα σε δέκα λεπτά λάθος κωδικό, αποκλείεται για 15 λεπτά. Αυτός ο υπολογιστής δεν αποκλείεται ποτέ.
- Μόνο στο δικό σου δίκτυο: Ο κωδικός ταξιδεύει στο δίκτυο χωρίς κρυπτογράφηση. Χρησιμοποίησε τη λειτουργία δικτύου μόνο στο δικό σου, προστατευμένο Wi-Fi – όχι στο ανοιχτό Wi-Fi επισκεπτών του χώρου.
- Τείχος προστασίας: Η εγκατάσταση δημιουργεί τον κανόνα, μόνο για ιδιωτικά δίκτυα. Αν η γραμμή κατάστασης δείχνει προειδοποίηση τείχους προστασίας, εγκατάστησε ξανά το BoothDock Studio ή επίτρεψέ το στα Windows, στο «Να επιτρέπεται μια εφαρμογή μέσω του τείχους προστασίας». Αν τα Windows θεωρούν το Wi-Fi δημόσιο, οι συσκευές δεν μπορούν να συνδεθούν – όρισε το προφίλ σε Ιδιωτικό στις ιδιότητες δικτύου.
Εντολές
| Εντολή | Αποτέλεσμα |
|---|---|
start?mode=print | Ξεκινά μια συνεδρία. Λειτουργίες: print (φωτογραφία), gif, boomerang, slowmo (360°· χωρίς 360° το Boomerang), video, ai. Λειτουργεί μόνο από την αρχική οθόνη, μόνο με ενεργοποιημένη λειτουργία και όχι όταν το Box είναι κλειδωμένο. Με πρότυπο, στυλ και φόντο: δες παρακάτω. |
auswahl?mode=print | Επιστρέφει στο Data τι μπορεί να επιλεγεί σε αυτή τη λειτουργία: vorlagen (Id και όνομα· κενό, αν είναι ενεργό μόνο ένα πρότυπο – αυτό βρίσκεται τότε στο vorgabeVorlage), hintergruende ανά πρότυπο και στη λειτουργία ai τα stile (από 1.5.13). |
cancel | Ακυρώνει την τρέχουσα συνεδρία και επιστρέφει στην αρχική οθόνη. |
status | Επιστρέφει στο Data: λειτουργία επισκεπτών ενεργή/ανενεργή, τρέχουσα οθόνη, λειτουργία, κλειδωμένο ναι/όχι – από 1.5.13 επίσης sperrgrund (manuell ή zeitfenster) και oeffnetUm. |
print?count=1 | Εκτυπώνει ξανά το τελευταίο αποτέλεσμα (1 έως 10 φύλλα). Τα βίντεο δεν εκτυπώνονται. |
lockscreen/show | Κλειδώνει το Box με το μήνυμα «Ένα λεπτό – συνεχίζουμε αμέσως.» ή με το δικό σου κείμενο και εικόνα (δες «Οθόνη κλειδώματος» παρακάτω). Η γωνία διαχείρισης παραμένει προσβάσιμη. Από 1.5.13 το κλείδωμα διατηρείται και μετά από επανεκκίνηση της εφαρμογής. |
lockscreen/exit | Αίρει το κλείδωμα – από 1.5.13 και το κλείδωμα λόγω χρονικού παραθύρου, μέχρι την επόμενη αλλαγή. |
share/email?email=… | Στέλνει το τελευταίο αποτέλεσμα με e-mail – απαιτεί σύζευξη με το Hub και την ενέργεια αποτελέσματος «Λάβετε μέσω ηλεκτρονικού ταχυδρομείου» (Σύστημα → Λειτουργία → Ενέργειες αποτελέσματος (επισκέπτης)· έως την 1.4.0 τον διακόπτη «Φωτογραφία μέσω e-mail (επισκέπτης)» κάτω από Σχεδιασμός → Οθόνες). |
share/sms | Δεν υπάρχει· η απάντηση το λέει ειλικρινά (IsSuccessful: false). |
createtestevent?name=… | Δημιουργεί μια δοκιμαστική εκδήλωση και την ενεργοποιεί. Το Data περιέχει eventId και eventName. Χωρίς όνομα δημιουργείται ένα με ημερομηνία. Μόνο εκτός λειτουργίας καλεσμένων (από 1.5.4). |
deletetestevent?eventId=… | Διαγράφει μια δοκιμαστική εκδήλωση που δημιουργήθηκε μέσω του API – ποτέ άλλες εκδηλώσεις. Μόνο εκτός λειτουργίας καλεσμένων (από 1.5.4). |
ping | Ελέγχει χωρίς κωδικό αν το API λειτουργεί. |
Αν το Box δεν απαντήσει μέσα σε 15 δευτερόλεπτα, επιστρέφεται IsSuccessful: false με μια επεξήγηση.
Έναρξη συνεδρίας με πρότυπο, στυλ και φόντο
Από την έκδοση 1.5.13 το start δέχεται την επιλογή απευθείας – το Box παραλείπει τότε ακριβώς αυτές τις οθόνες επιλογής:
vorlage=<Id>(ήtemplate=) – το πρότυπο, μόνο στη λειτουργίαprint(φωτογραφία). Τα Id τα δίνει τοauswahl?mode=print.stil=<Id>(ήstyle=) – το στυλ AI, μόνο στη λειτουργίαai.hintergrund=<Id>(ήbackground=) – το φόντο για την απομόνωση, ταιριαστό με το πρότυπο.
Παράδειγμα: http://localhost:1500/api/start?mode=print&vorlage=hochzeit-gold&hintergrund=strand&password=Ο-ΚΩΔΙΚΟΣ-ΣΟΥ
Ένα άγνωστο ή μη ταιριαστό Id δεν ξεκινά συνεδρία: το IsSuccessful είναι false και το ErrorMessage αναφέρει τον λόγο. Τη συγκατάθεση απορρήτου και τη φόρμα στοιχείων επισκεπτών το Box τις εμφανίζει πάντα μόνο του – αφορούν τον επισκέπτη μπροστά στο Box και δεν μπορούν να γίνουν εκ των προτέρων μέσω του API.
Οθόνη κλειδώματος
Στο Εκδηλώσεις → Οθόνη κλειδώματος (από 1.5.13) ορίζεις τι δείχνει ένα κλειδωμένο Box: δικό σου κείμενο, δική σου εικόνα και – με χρονικό παράθυρο – μια μεγάλη αντίστροφη μέτρηση μέχρι το άνοιγμα.
- Χρονικό παράθυρο ανά εκδήλωση: Με τα Ανοίγει στις και Κλείνει στις το Box είναι κλειδωμένο πριν από την έναρξη και μετά το τέλος.
- Ξεκλείδωμα στη συσκευή: Αν έχει οριστεί PIN χειριστή (Σύστημα → Προστασία), η οθόνη κλειδώματος δείχνει ένα μικρό λουκέτο. Όποιος γνωρίζει το PIN ξεκλειδώνει το Box. Αν ξεκλειδωθεί πριν από την έναρξη, μένει ανοιχτό μέχρι το τέλος.
- Εξ αποστάσεως: Στο Hub, κάτω από Καμπίνες, κλειδώνεις και ξεκλειδώνεις κάθε Box που το υποστηρίζει (Studio από 1.5.13). Το ίδιο γίνεται μέσω του BoothDock Station και με
lockscreen/show/lockscreen/exit.
Μια συνεδρία σε εξέλιξη δεν διακόπτεται ούτε από το κλείδωμα από το Hub ούτε από το χρονικό παράθυρο – το Box κλειδώνει μόλις ο επισκέπτης τελειώσει.
Εξαγωγή σε πραγματικό χρόνο
Στην ίδια καρτέλα: κάθε ολοκληρωμένο αρχείο αποθηκεύεται αμέσως στο ίδιο το Box (Τοπικό αντίγραφο) – και χωρίς Hub, ταξινομημένο ανά εκδήλωση και τύπο (εκτυπώσεις, πρωτότυπα, GIF, βίντεο – απενεργοποιούνται ξεχωριστά). Αυτό το αντίγραφο δεν διαγράφεται ποτέ αυτόματα. Στο Στικ USB / δεύτερος φάκελος προσθέτεις δεύτερο προορισμό: το Αυτόματη εγγραφή σε στικ USB γράφει σε κάθε συνδεδεμένο stick, το Συμπλήρωση αρχείων που χάθηκαν συμπληρώνει ό,τι δημιουργήθηκε χωρίς stick. Εναλλακτικά ορίζεις Σταθερός δεύτερος φάκελος (έχει προτεραιότητα), π.χ. έναν φάκελο cloud (OneDrive, Dropbox). Αν ένας επισκέπτης διαγράψει τη συνεδρία του στο μηχάνημα, εξαφανίζονται και τα αντίγραφα. Σε iPad και iPhone: Στην εφαρμογή Αρχεία στο «Στο iPad μου › BoothDock Studio › Export». Στο BoothDock Studio 1.5.3 και παλαιότερα υπάρχει αντί γι' αυτό μόνο το Φάκελος εξαγωγής.
Έναρξη με τηλεχειριστήριο
Στην ίδια καρτέλα κάνεις εκμάθηση ενός πλήκτρου στο Έναρξη με τηλεχειριστήριο. Τα χειριστήρια παρουσιάσεων, τα κουμπιά USB και οι ποδοδιακόπτες στέλνουν συνήθως το πλήκτρο διαστήματος· αυτό είναι προρυθμισμένο. Στο Ξεκινά επιλέγεις τι ενεργοποιεί το πλήκτρο στην αρχική οθόνη: Όπως το άγγιγμα (κανονική ροή) ή κατευθείαν μια λειτουργία, για παράδειγμα 360° στην πλατφόρμα. Στο BoothDock Studio 1.4.0 και σε παλαιότερες εκδόσεις το πλήκτρο υπάρχει μόνο για το 360°, δες 360° / Αργή κίνηση.
Αντιμετώπιση προβλημάτων
- Δεν συμβαίνει τίποτα: Υπάρχει κάτι στο αρχείο καταγραφής; Τα webhooks γράφουν στο
webhooks.log(έως την 1.4.0:ausloeser.log), το API στοlokale-api.log– και τα δύο στον φάκελο%LocalAppData%\Boothdock Studio\logs(Windows). Τα απορριφθέντα αιτήματα (λάθος κωδικός, ξένη συσκευή) καταγράφονται εκεί το πολύ μία φορά το λεπτό. - «Invalid password.» – αντίγραψε ξανά τον κωδικό· μετά από Νέος κωδικός ο παλιός δεν ισχύει πια.
- «The booth is not on the start screen …» – το
startλειτουργεί μόνο από την αρχική οθόνη. Πρώταcancel, μετάstart. - «Too many failed attempts …» – η συσκευή έστειλε πάρα πολλές φορές λάθος κωδικό. Περίμενε 15 λεπτά και έλεγξε τον κωδικό.
- Το κινητό δεν φτάνει στο Box, ενώ στον υπολογιστή όλα λειτουργούν: σχεδόν πάντα φταίει το Τείχος προστασίας των Windows ή ένα Wi-Fi που θεωρείται δημόσιο – δες παραπάνω. Η γραμμή κατάστασης αναφέρει και τις δύο περιπτώσεις.