Fysieke knoppen: arcade, pedaal, presenter-afstandsbediening
Sluit een knop via USB aan en hij werkt, zonder iets in te stellen. Op het welkomstscherm start een druk de sessie; op het livebeeld neemt hij de foto of stopt de video. Elders doet hij niets, omdat die schermen om een keuze vragen die één knop niet kan maken.
- Toetsenbordencoders, USB-pedalen en presenter-afstandsbedieningen: Spatie, Enter, Page Up/Down, pijltjestoetsen, F13 tot F15 of play/pause.
- “Zero delay”-arcade-encoders, door Windows gezien als een gamecontroller: elke knop.
- Drukken met minder dan 400 ms ertussen tellen als één, zodat een stuiterend contact geen twee foto's maakt.
Triggers: een webhook of een programma bij elk event
Voor al het andere zijn er triggers. Elke trigger stel je in via het booth-beheer, luistert naar de events die je kiest en roept een URL aan of start een programma op de booth-pc.
- WebhookEen HTTP POST met een JSON-body, ondertekend met HMAC-SHA256 met jouw geheim. Headers: X-Froozbooth-Event, X-Froozbooth-Timestamp, X-Froozbooth-Signature.
- ProgrammaEen uitvoerbaar bestand op de booth-pc, opgegeven als absoluut pad en toegestaan in de allowlist van de hardwareservice. Benoemde argumenten: --event, --session, --booth-event, --ts, --device, daarna de eventgegevens.
De 17 events waarop je kunt luisteren
- Sessie: session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.canceled.
- Uitvoer: print.sent, print.done, share.email.sent, share.qr.shown.
- Fouten: error.capture, error.compose, error.print, error.camera, error.disk, error.license.
Elk bericht bevat een formaatversie (v), de eventnaam, een tijdstempel in ISO 8601, de sessie-id, de event-id, de machine-id en een data-object dat bij het event hoort.
Gebouwd voor een liveavond
- Een trigger vertraagt de sessie nooit: na 2 seconden zonder antwoord gaat de booth verder.
- Drie pogingen, na 0,5, 2 en 5 seconden. Later zou een flits na de pose vallen.
- Een event ouder dan 60 seconden wordt gelogd, niet opnieuw afgespeeld: na een herstart geen flits midden in het diner.
- Een Test-knop verstuurt een voorbeeldevent en toont het antwoord, een uur voordat de deuren opengaan.
- De laatste 200 verzendingen worden gelogd met status, code en latentie en zijn te exporteren naar CSV.
Kant-en-klare recepten
- Studioflits bij het begin van het aftellen, via een DMX- of Art-Net-gateway.
- Een puls of een geluid bij elke opname.
- Terug naar omgevingslicht aan het eind van de sessie, via een Philips Hue-bridge.
Camera's, printers en pc's: de hardware die Froozbooth rechtstreeks aanstuurt staat op de hardwarepagina. Spiegelreflex photobooth software voor Canon en Nikon: camera's en printers die werken
Veelgestelde vragen
Werkt een arcadeknop met Froozbooth?
Ja. Een toetsenbordencoder of een “zero delay”-encoder die via USB is aangesloten werkt zonder instellingen: een druk start de sessie op het welkomstscherm en neemt de foto op het livebeeld.
Kan Froozbooth DMX-lichten of een rookmachine aansturen?
Via een trigger. Froozbooth stuurt het event naar een webhook of een programma, en je DMX- of Art-Net-gateway, Hue-bridge of script stuurt het apparaat aan.
Hoe controleer ik dat een webhook echt van de booth komt?
Bereken de HMAC-SHA256 van de ruwe request-body met jouw geheim en vergelijk die met de header X-Froozbooth-Signature. Het veld ts, in de ondertekende body, laat je oude verzoeken weigeren.
Kan een trage trigger gasten laten wachten?
Nee. Een trigger krijgt 2 seconden; daarna gaat de booth verder en probeert het op de achtergrond opnieuw.
Kan ik een voetpedaal of een presenter-afstandsbediening gebruiken om de foto te nemen?
Ja. Froozbooth herkent USB-pedalen en presenter-afstandsbedieningen zonder instellingen, zolang ze Spatie, Enter, Page Up/Down, een pijltjestoets, F13 tot F15 of play/pause sturen. Een druk start de sessie op het welkomstscherm en neemt de foto of stopt de video op het livebeeld. Op andere schermen doet hij niets, omdat die om een keuze vragen die één knop niet kan maken.
Wat gebeurt er als een gast twee keer op de photobooth-knop drukt?
Froozbooth telt drukken met minder dan 400 ms ertussen als één, zodat een stuiterend contact of een snelle dubbele druk geen twee foto's maakt. Een druk op een scherm dat om een keuze vraagt, zoals het kiezen van een modus, doet niets.
Welke photobooth-events kunnen een webhook activeren?
Froozbooth biedt 17 events: sessiestappen (session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.canceled), uitvoer (print.sent, print.done, share.email.sent, share.qr.shown) en fouten (error.capture, error.compose, error.print, error.camera, error.disk, error.license). Elke trigger luistert alleen naar de events die je kiest. Elk bericht bevat een formaatversie, de eventnaam, een tijdstempel in ISO 8601, de sessie-, event- en machine-id's en gegevens die bij het event horen.
Kan ik een script draaien op de booth-pc als er een foto wordt genomen?
Ja, met een programmatrigger. Froozbooth start een uitvoerbaar bestand op de booth-pc bij de events die je kiest, zoals shot.taken; het moet als absoluut pad worden opgegeven en zijn toegestaan in de allowlist van de hardwareservice. Het ontvangt benoemde argumenten (--event, --session, --booth-event, --ts, --device), gevolgd door de eventgegevens.
Hoe test ik een photobooth-trigger voordat de gasten komen?
Gebruik de Test-knop in het booth-beheer: Froozbooth verstuurt een voorbeeldevent en toont het antwoord. De laatste 200 verzendingen worden gelogd met status, code en latentie en zijn te exporteren naar CSV. Een event ouder dan 60 seconden wordt gelogd in plaats van opnieuw afgespeeld, dus een herstart veroorzaakt geen flits midden in het diner.
Kan de photobooth me waarschuwen als de printer of camera uitvalt?
Ja, met een trigger op de foutevents: error.print, error.camera, error.capture, error.compose, error.disk en error.license. Richt hem op een webhook van je eigen dienst om de melding te krijgen waar je maar wilt. De pagina Machines van het dashboard toont ook de status van elke booth live, en je kunt hem aan het startscherm van je telefoon toevoegen.