Declanșatoare photo booth: butoane, lumini și webhooks

O cabină rareori lucrează singură: un buton arcade pornește sesiunea, luminile de studio fac bliț la numărătoarea inversă, un bridge Hue readuce lumina din sală între grupuri. Froozbooth gestionează butoanele fizice din start și trimite fiecare pas al sesiunii către propriul dumneavoastră echipament. Iată ce trimite și cum.

Butoane fizice: arcade, pedală, telecomandă de prezentări

Conectați un buton prin USB și funcționează, fără nimic de configurat. Pe ecranul de întâmpinare, o apăsare pornește sesiunea; pe previzualizarea live, face poza sau oprește videoul. În rest nu face nimic, pentru că acele ecrane cer o alegere pe care un singur buton nu o poate face.

  • Encodere de tastatură, pedale USB și telecomenzi de prezentări: Space, Enter, Page Up/Down, tastele săgeți, F13 până la F15 sau play/pauză.
  • Encodere arcade „zero delay”, văzute de Windows ca un controler de joc: orice buton.
  • Apăsările la mai puțin de 400 ms distanță se numără o singură dată, ca un contact care sare să nu facă două poze.

Declanșatoare: un webhook sau un program la fiecare eveniment

Pentru orice altceva există declanșatoarele. Fiecare se configurează în administrarea cabinei, ascultă evenimentele alese de dumneavoastră și apelează un URL sau pornește un program pe calculatorul cabinei.

  • WebhookUn HTTP POST cu un corp JSON, semnat HMAC-SHA256 cu secretul dumneavoastră. Anteturi: X-Froozbooth-Event, X-Froozbooth-Timestamp, X-Froozbooth-Signature.
  • ProgramUn executabil de pe calculatorul cabinei, dat ca o cale absolută și permis în lista de permisiuni a serviciului hardware. Argumente numite: --event, --session, --booth-event, --ts, --device, apoi datele evenimentului.

Cele 17 evenimente pe care le puteți asculta

  • Sesiune: session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.canceled.
  • Ieșire: print.sent, print.done, share.email.sent, share.qr.shown.
  • Erori: error.capture, error.compose, error.print, error.camera, error.disk, error.license.

Fiecare mesaj poartă o versiune de format (v), numele evenimentului, o marcă de timp ISO 8601, id-ul sesiunii, id-ul evenimentului, id-ul mașinii și un obiect de date specific evenimentului.

Făcut pentru o seară live

  • Un declanșator nu întârzie niciodată sesiunea: după 2 secunde fără răspuns, cabina merge mai departe.
  • Trei reîncercări, după 0,5, 2 și 5 secunde. Mai târziu, un bliț ar ajunge după poză.
  • Un eveniment mai vechi de 60 de secunde este înregistrat în jurnal, nu reluat: după o repornire, niciun bliț în mijlocul cinei.
  • Un buton Test trimite un eveniment de probă și arată răspunsul, cu o oră înainte să se deschidă ușile.
  • Ultimele 200 de trimiteri sunt înregistrate cu stare, cod și latență și se exportă în CSV.

Rețete gata făcute

  • Bliț de studio la începutul numărătorii inverse, printr-un gateway DMX sau Art-Net.
  • Un puls sau un sunet la fiecare poză.
  • Revenirea la lumina ambientală la sfârșitul sesiunii, printr-un bridge Philips Hue.

Camere, imprimante și calculatoare: echipamentul pe care Froozbooth îl conduce direct se află pe pagina de hardware. Software photo booth DSLR pentru Canon și Nikon: camere și imprimante care funcționează

Întrebări frecvente

Funcționează un buton arcade cu Froozbooth?

Da. Un encoder de tastatură sau un encoder „zero delay” conectat prin USB funcționează fără configurare: o apăsare pornește sesiunea pe ecranul de întâmpinare și face poza pe previzualizarea live.

Poate Froozbooth să controleze lumini DMX sau o mașină de fum?

Printr-un declanșator. Froozbooth trimite evenimentul către un webhook sau un program, iar gatewayul DMX sau Art-Net, bridgeul Hue ori scriptul dumneavoastră conduce dispozitivul.

Cum verific că un webhook vine într-adevăr de la cabină?

Calculați HMAC-SHA256 al corpului brut al cererii cu secretul dumneavoastră și comparați-l cu antetul X-Froozbooth-Signature. Câmpul ts, aflat în corpul semnat, vă lasă să refuzați cererile vechi.

Poate un declanșator lent să îi țină pe invitați în așteptare?

Nu. Un declanșator primește 2 secunde; dincolo de ele, cabina merge mai departe și reîncearcă în fundal.

Pot folosi o pedală sau o telecomandă de prezentări ca să fac poza?

Da. Froozbooth recunoaște pedalele USB și telecomenzile de prezentări fără configurare, atât timp cât trimit Space, Enter, Page Up/Down, o tastă săgeată, F13 până la F15 sau play/pauză. O apăsare pornește sesiunea pe ecranul de întâmpinare și face poza sau oprește videoul pe previzualizarea live. Pe celelalte ecrane nu face nimic, pentru că ele cer o alegere pe care un singur buton nu o poate face.

Ce se întâmplă dacă un invitat apasă de două ori butonul cabinei foto?

Froozbooth numără apăsările la mai puțin de 400 ms distanță ca pe una singură, deci un contact care sare sau o dublă apăsare rapidă nu face două poze. O apăsare pe un ecran care cere o alegere, cum ar fi alegerea unui mod, nu face nimic.

Ce evenimente ale cabinei pot declanșa un webhook?

Froozbooth expune 17 evenimente: pașii sesiunii (session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.canceled), ieșirile (print.sent, print.done, share.email.sent, share.qr.shown) și erorile (error.capture, error.compose, error.print, error.camera, error.disk, error.license). Fiecare declanșator ascultă doar evenimentele alese de dumneavoastră. Fiecare mesaj poartă o versiune de format, numele evenimentului, o marcă de timp ISO 8601, id-urile sesiunii, evenimentului și mașinii, și date specifice evenimentului.

Pot rula un script pe calculatorul cabinei când se face o poză?

Da, cu un declanșator de tip program. Froozbooth pornește un executabil pe calculatorul cabinei la evenimentele alese de dumneavoastră, de exemplu shot.taken; el trebuie dat ca o cale absolută și permis în lista de permisiuni a serviciului hardware. Primește argumente numite (--event, --session, --booth-event, --ts, --device), urmate de datele evenimentului.

Cum testez un declanșator al cabinei înainte să sosească invitații?

Folosiți butonul Test din administrarea cabinei: Froozbooth trimite un eveniment de probă și arată răspunsul. Ultimele 200 de trimiteri sunt înregistrate cu stare, cod și latență și se exportă în CSV. Un eveniment mai vechi de 60 de secunde este înregistrat în jurnal, nu reluat, deci o repornire nu declanșează un bliț în mijlocul cinei.

Mă poate alerta cabina când imprimanta sau camera se defectează?

Da, cu un declanșator pe evenimentele de eroare: error.print, error.camera, error.capture, error.compose, error.disk și error.license. Îndreptați-l spre un webhook al propriului serviciu ca să primiți alerta unde doriți. Pagina Mașini din dashboard arată și starea fiecărei cabine în timp real, iar o puteți adăuga pe ecranul de pornire al telefonului.

Gata pentru următorul eveniment?