Fizyczne przyciski: arcade, pedał, pilot do prezentacji
Podłącz przycisk przez USB i działa, bez niczego do konfiguracji. Na ekranie powitalnym naciśnięcie rozpoczyna sesję; w podglądzie na żywo robi zdjęcie lub zatrzymuje wideo. Gdzie indziej nic nie robi, bo te ekrany wymagają wyboru, którego pojedynczy przycisk nie może dokonać.
- Enkodery klawiatury, pedały USB i piloty do prezentacji: Spacja, Enter, Page Up/Down, klawisze strzałek, F13 do F15 lub play/pause.
- Enkodery arcade „zero delay”, widziane przez Windows jako kontroler do gier: dowolny przycisk.
- Naciśnięcia w odstępie krótszym niż 400 ms liczą się jako jedno, więc drgający styk nie zrobi dwóch zdjęć.
Wyzwalacze: webhook lub program przy każdym zdarzeniu
Do wszystkiego innego służą wyzwalacze. Każdy z nich ustawia się w panelu administratora fotobudki, nasłuchuje wybranych zdarzeń i wywołuje adres URL albo uruchamia program na komputerze fotobudki.
- WebhookHTTP POST z treścią JSON, podpisany HMAC-SHA256 Twoim sekretem. Nagłówki: X-Froozbooth-Event, X-Froozbooth-Timestamp, X-Froozbooth-Signature.
- ProgramPlik wykonywalny na komputerze fotobudki, podany jako ścieżka bezwzględna i dopuszczony na liście dozwolonych usługi sprzętowej. Nazwane argumenty: --event, --session, --booth-event, --ts, --device, potem dane zdarzenia.
17 zdarzeń, których możesz słuchać
- Sesja: session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.canceled.
- Wyjście: print.sent, print.done, share.email.sent, share.qr.shown.
- Błędy: error.capture, error.compose, error.print, error.camera, error.disk, error.license.
Każda wiadomość niesie wersję formatu (v), nazwę zdarzenia, znacznik czasu ISO 8601, identyfikator sesji, identyfikator eventu, identyfikator maszyny i obiekt data właściwy dla zdarzenia.
Zbudowane na żywą noc
- Wyzwalacz nigdy nie opóźnia sesji: po 2 sekundach bez odpowiedzi fotobudka idzie dalej.
- Trzy ponowienia, po 0,5, 2 i 5 sekundach. Później błysk wypadłby po pozowaniu.
- Zdarzenie starsze niż 60 sekund jest zapisywane w dzienniku, a nie odtwarzane: po restarcie żaden błysk w środku kolacji.
- Przycisk Test wysyła przykładowe zdarzenie i pokazuje odpowiedź, godzinę przed otwarciem drzwi.
- Ostatnie 200 wysyłek jest zapisywanych ze statusem, kodem i opóźnieniem i eksportuje się do CSV.
Gotowe przepisy
- Błysk studyjny na początku odliczania, przez bramkę DMX lub Art-Net.
- Impuls lub dźwięk przy każdym zdjęciu.
- Powrót do światła otoczenia na końcu sesji, przez mostek Philips Hue.
Aparaty, drukarki i komputery: sprzęt, którym Froozbooth steruje bezpośrednio, znajdziesz na stronie o sprzęcie. Oprogramowanie do fotobudki z lustrzanką Canon i Nikon: aparaty i drukarki, które działają
Najczęstsze pytania
Czy przycisk arcade działa z Froozbooth?
Tak. Enkoder klawiatury lub enkoder „zero delay” podłączony przez USB działa bez konfiguracji: naciśnięcie rozpoczyna sesję na ekranie powitalnym i robi zdjęcie w podglądzie na żywo.
Czy Froozbooth może sterować światłami DMX lub wytwornicą dymu?
Przez wyzwalacz. Froozbooth wysyła zdarzenie do webhooka lub programu, a Twoja bramka DMX lub Art-Net, mostek Hue albo skrypt steruje urządzeniem.
Jak sprawdzić, że webhook naprawdę pochodzi z fotobudki?
Oblicz HMAC-SHA256 surowej treści żądania swoim sekretem i porównaj z nagłówkiem X-Froozbooth-Signature. Pole ts, wewnątrz podpisanej treści, pozwala odrzucać stare żądania.
Czy wolny wyzwalacz może kazać gościom czekać?
Nie. Wyzwalacz dostaje 2 sekundy; po tym czasie fotobudka idzie dalej i ponawia próbę w tle.
Czy do zrobienia zdjęcia mogę użyć pedału nożnego lub pilota do prezentacji?
Tak. Froozbooth rozpoznaje pedały USB i piloty do prezentacji bez konfiguracji, o ile wysyłają Spację, Enter, Page Up/Down, klawisz strzałki, F13 do F15 lub play/pause. Naciśnięcie rozpoczyna sesję na ekranie powitalnym i robi zdjęcie lub zatrzymuje wideo w podglądzie na żywo. Na innych ekranach nic nie robi, bo wymagają wyboru, którego pojedynczy przycisk nie może dokonać.
Co się stanie, gdy gość dwa razy naciśnie przycisk fotobudki?
Froozbooth liczy naciśnięcia w odstępie krótszym niż 400 ms jako jedno, więc drgający styk lub szybkie podwójne naciśnięcie nie zrobi dwóch zdjęć. Naciśnięcie na ekranie, który wymaga wyboru, na przykład trybu, nic nie robi.
Które zdarzenia fotobudki mogą uruchomić webhook?
Froozbooth udostępnia 17 zdarzeń: kroki sesji (session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.canceled), wyjścia (print.sent, print.done, share.email.sent, share.qr.shown) i błędy (error.capture, error.compose, error.print, error.camera, error.disk, error.license). Każdy wyzwalacz nasłuchuje tylko wybranych zdarzeń. Każda wiadomość niesie wersję formatu, nazwę zdarzenia, znacznik czasu ISO 8601, identyfikatory sesji, eventu i maszyny oraz dane właściwe dla zdarzenia.
Czy mogę uruchomić skrypt na komputerze fotobudki, gdy zostanie zrobione zdjęcie?
Tak, wyzwalaczem typu program. Froozbooth uruchamia plik wykonywalny na komputerze fotobudki przy wybranych zdarzeniach, na przykład shot.taken; musi być podany jako ścieżka bezwzględna i dopuszczony na liście dozwolonych usługi sprzętowej. Otrzymuje nazwane argumenty (--event, --session, --booth-event, --ts, --device), a po nich dane zdarzenia.
Jak przetestować wyzwalacz fotobudki, zanim przyjdą goście?
Użyj przycisku Test w panelu administratora fotobudki: Froozbooth wysyła przykładowe zdarzenie i pokazuje odpowiedź. Ostatnie 200 wysyłek jest zapisywanych ze statusem, kodem i opóźnieniem i eksportuje się do CSV. Zdarzenie starsze niż 60 sekund jest zapisywane w dzienniku, a nie odtwarzane, więc restart nie wywoła błysku w środku kolacji.
Czy fotobudka może mnie powiadomić, gdy drukarka lub aparat zawiedzie?
Tak, wyzwalaczem na zdarzenia błędów: error.print, error.camera, error.capture, error.compose, error.disk i error.license. Skieruj go na webhook we własnej usłudze, aby dostać powiadomienie tam, gdzie chcesz. Strona Maszyny w panelu też pokazuje na żywo stan każdej fotobudki i możesz dodać ją do ekranu głównego telefonu.