Taster: Buzzer, Fußpedal, Presenter
Schließen Sie einen Taster per USB an, und er funktioniert, ohne Einstellungen. Auf dem Startbildschirm startet ein Druck die Sitzung, in der Live-Ansicht macht er das Foto oder stoppt das Video. Anderswo tut er nichts: Diese Bildschirme verlangen eine Auswahl, die ein einzelner Taster nicht treffen kann.
- Tastatur-Encoder, USB-Fußpedale und Presenter: Leertaste, Enter, Bild auf und ab, Pfeiltasten, F13 bis F15 oder Play/Pause.
- Arcade-Encoder „Zero Delay“, die Windows als Gamecontroller erkennt: jeder Knopf.
- Zwei Drücke im Abstand von unter 400 ms zählen einmal: Ein prellender Kontakt macht keine zwei Fotos.
Trigger: ein Webhook oder ein Programm zu jedem Ereignis
Für alles andere gibt es Trigger. Jeder wird in der Verwaltung der Fotobox eingerichtet, hört auf die gewählten Ereignisse und ruft eine URL auf oder startet ein Programm auf dem PC der Box.
- WebhookEin HTTP-POST mit JSON-Body, signiert mit HMAC-SHA256 und Ihrem Secret. Header: X-Froozbooth-Event, X-Froozbooth-Timestamp, X-Froozbooth-Signature.
- ProgrammEine ausführbare Datei auf dem PC der Box, angegeben mit absolutem Pfad und in der Allowlist des Hardware-Dienstes freigegeben. Benannte Argumente: --event, --session, --booth-event, --ts, --device, dann die Ereignisdaten.
Die 17 Ereignisse
- Sitzung: session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.cancelled.
- Ausgabe: print.sent, print.done, share.email.sent, share.qr.shown.
- Fehler: error.capture, error.compose, error.print, error.camera, error.disk, error.license.
Jede Nachricht enthält eine Formatversion (v), den Ereignisnamen, einen ISO-8601-Zeitstempel, die Sitzungs-ID, die Ereignis-ID, die Geräte-ID und ein Objekt data mit den Daten des Ereignisses.
Gebaut für den Live-Abend
- Ein Trigger verzögert nie die Sitzung: Kommt nach 2 Sekunden keine Antwort, läuft die Box weiter.
- Drei neue Versuche, nach 0,5, 2 und 5 Sekunden. Später käme ein Blitz erst nach der Pose.
- Ein Ereignis, das älter als 60 Sekunden ist, wird protokolliert, nicht nachgeholt: nach einem Neustart kein Blitz mitten im Abendessen.
- Ein Test-Knopf sendet ein Beispielereignis und zeigt die Antwort, eine Stunde vor Einlass.
- Die letzten 200 Sendungen werden mit Status, Code und Latenz protokolliert und lassen sich als CSV exportieren.
Fertige Rezepte
- Studioblitz zu Beginn des Countdowns, über ein DMX- oder Art-Net-Gateway.
- Ein Impuls oder ein Ton bei jeder Aufnahme.
- Zurück zum Ambiente-Licht am Ende der Sitzung, über eine Philips-Hue-Bridge.
Kameras, Drucker und PCs: Die Technik, die Froozbooth direkt steuert, steht auf der Hardware-Seite. Fotobox-Software für Canon und Nikon: kompatible Kameras und Drucker
Häufige Fragen
Funktioniert ein Buzzer mit Froozbooth?
Ja. Ein Tastatur- oder „Zero Delay“-Encoder per USB funktioniert ohne Einrichtung: Ein Druck startet auf dem Startbildschirm die Sitzung und macht in der Live-Ansicht das Foto.
Kann Froozbooth DMX-Licht oder eine Nebelmaschine steuern?
Über einen Trigger. Froozbooth sendet das Ereignis an einen Webhook oder ein Programm, und Ihr DMX- oder Art-Net-Gateway, Ihre Hue-Bridge oder Ihr Skript steuert das Gerät.
Wie prüfe ich, dass ein Webhook wirklich von der Fotobox kommt?
Berechnen Sie den HMAC-SHA256 des unveränderten Request-Bodys mit Ihrem Secret und vergleichen Sie ihn mit dem Header X-Froozbooth-Signature. Das Feld ts im signierten Body erlaubt es, alte Anfragen abzulehnen.
Kann ein langsamer Trigger die Gäste warten lassen?
Nein. Ein Trigger hat 2 Sekunden; danach läuft die Box weiter und versucht es im Hintergrund erneut.
Kann ich das Foto mit einem Fußpedal oder einem Presenter auslösen?
Ja. Froozbooth erkennt USB-Fußpedale und Presenter ohne Einrichtung, sofern sie Leertaste, Enter, Bild auf oder ab, eine Pfeiltaste, F13 bis F15 oder Play/Pause senden. Ein Druck startet auf dem Startbildschirm die Sitzung und macht in der Live-Ansicht das Foto oder stoppt das Video. Auf anderen Bildschirmen tut er nichts, weil sie eine Auswahl verlangen, die ein einzelner Taster nicht treffen kann.
Was passiert, wenn ein Gast zweimal auf den Buzzer drückt?
Froozbooth zählt zwei Drücke im Abstand von unter 400 ms als einen: Ein prellender Kontakt oder ein schneller Doppeldruck macht keine zwei Fotos. Ein Druck auf einem Bildschirm, der eine Auswahl verlangt, etwa die Modusauswahl, bewirkt nichts.
Welche Fotobox-Ereignisse können einen Webhook auslösen?
Froozbooth bietet 17 Ereignisse: die Schritte der Sitzung (session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.cancelled), die Ausgaben (print.sent, print.done, share.email.sent, share.qr.shown) und die Fehler (error.capture, error.compose, error.print, error.camera, error.disk, error.license). Jeder Trigger hört nur auf die Ereignisse, die Sie wählen. Jede Nachricht enthält eine Formatversion, den Ereignisnamen, einen ISO-8601-Zeitstempel, die IDs von Sitzung, Event und Gerät sowie ereignisspezifische Daten.
Kann ich bei jedem Foto ein Skript auf dem PC der Fotobox starten?
Ja, mit einem Programm-Trigger. Froozbooth startet bei den gewählten Ereignissen, etwa shot.taken, eine ausführbare Datei auf dem PC der Box; sie wird mit absolutem Pfad angegeben und muss in der Allowlist des Hardware-Dienstes freigegeben sein. Sie erhält benannte Argumente (--event, --session, --booth-event, --ts, --device), dann die Ereignisdaten.
Wie teste ich einen Trigger, bevor die Gäste kommen?
Mit dem Test-Knopf in der Verwaltung der Fotobox: Froozbooth sendet ein Beispielereignis und zeigt die Antwort. Die letzten 200 Sendungen werden mit Status, Code und Latenz protokolliert und lassen sich als CSV exportieren. Ein Ereignis, das älter als 60 Sekunden ist, wird protokolliert, nicht nachgeholt: Nach einem Neustart blitzt es nicht mitten ins Abendessen.
Kann mich die Fotobox benachrichtigen, wenn Drucker oder Kamera ausfallen?
Ja, mit einem Trigger auf die Fehlerereignisse: error.print, error.camera, error.capture, error.compose, error.disk und error.license. Richten Sie ihn auf einen Webhook Ihres eigenen Dienstes, um die Meldung dort zu erhalten, wo Sie wollen. Die Seite „Geräte“ im Dashboard zeigt außerdem den Zustand jeder Fotobox live, und Sie können sie auf dem Home-Bildschirm Ihres Handys installieren.