Fysiska knappar: arkad, pedal, presentationsfjärrkontroll
Anslut en knapp via USB så fungerar den, utan något att ställa in. På välkomstskärmen startar ett tryck sessionen; i liveläget tar det fotot eller stoppar videon. På andra skärmar gör det ingenting, eftersom de ber om ett val som en enda knapp inte kan göra.
- Tangentbordskodare, USB-pedaler och presentationsfjärrkontroller: mellanslag, Enter, Page Up/Down, piltangenter, F13 till F15 eller play/paus.
- ”Zero delay”-arkadkodare, som Windows ser som en spelkontroll: valfri knapp.
- Tryck med mindre än 400 ms emellan räknas som ett, så en studsande kontakt tar inte två foton.
Utlösare: en webhook eller ett program vid varje händelse
För allt annat finns utlösare. Var och en ställs in i båsets administration, lyssnar på de händelser du väljer och anropar en URL eller startar ett program på båsets dator.
- WebhookEn HTTP POST med en JSON-kropp, signerad med HMAC-SHA256 med din hemlighet. Rubriker: X-Froozbooth-Event, X-Froozbooth-Timestamp, X-Froozbooth-Signature.
- ProgramEn körbar fil på båsets dator, angiven som en absolut sökväg och tillåten i hårdvarutjänstens tillåtelselista. Namngivna argument: --event, --session, --booth-event, --ts, --device, därefter händelsedata.
De 17 händelserna du kan lyssna på
- Session: session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.canceled.
- Utdata: print.sent, print.done, share.email.sent, share.qr.shown.
- Fel: error.capture, error.compose, error.print, error.camera, error.disk, error.license.
Varje meddelande bär en formatversion (v), händelsens namn, en ISO 8601-tidsstämpel, sessions-id, evenemangs-id, maskin-id och ett dataobjekt som är specifikt för händelsen.
Byggt för en kväll live
- En utlösare försenar aldrig sessionen: efter 2 sekunder utan svar går båset vidare.
- Tre nya försök, efter 0,5, 2 och 5 sekunder. Senare skulle en blixt komma efter posen.
- En händelse som är äldre än 60 sekunder loggas, spelas inte upp igen: efter en omstart blixtrar det inte mitt under middagen.
- En Test-knapp skickar en exempelhändelse och visar svaret, en timme innan dörrarna öppnas.
- De senaste 200 utskicken loggas med status, kod och latens, och kan exporteras till CSV.
Färdiga recept
- Studioblixt vid början av nedräkningen, via en DMX- eller Art-Net-gateway.
- En puls eller ett ljud vid varje foto.
- Tillbaka till rumsljus i slutet av sessionen, via en Philips Hue-brygga.
Kameror, skrivare och datorer: utrustningen som Froozbooth styr direkt finns på sidan om utrustning. Fotobåssprogram för systemkamera, Canon och Nikon: kameror och skrivare som fungerar
Vanliga frågor
Fungerar en arkadknapp med Froozbooth?
Ja. En tangentbordskodare eller en ”zero delay”-kodare ansluten via USB fungerar utan inställning: ett tryck startar sessionen på välkomstskärmen och tar fotot i liveläget.
Kan Froozbooth styra DMX-ljus eller en rökmaskin?
Via en utlösare. Froozbooth skickar händelsen till en webhook eller ett program, och din DMX- eller Art-Net-gateway, Hue-brygga eller ditt skript styr enheten.
Hur kontrollerar jag att en webhook verkligen kommer från båset?
Beräkna HMAC-SHA256 av den råa begärans kropp med din hemlighet och jämför med rubriken X-Froozbooth-Signature. Fältet ts, inuti den signerade kroppen, låter dig avvisa gamla begäranden.
Kan en långsam utlösare låta gäster vänta?
Nej. En utlösare får 2 sekunder; därefter går båset vidare och försöker igen i bakgrunden.
Kan jag använda en fotpedal eller en presentationsfjärrkontroll för att ta fotot?
Ja. Froozbooth känner igen USB-pedaler och presentationsfjärrkontroller utan inställning, så länge de skickar mellanslag, Enter, Page Up/Down, en piltangent, F13 till F15 eller play/paus. Ett tryck startar sessionen på välkomstskärmen och tar fotot eller stoppar videon i liveläget. På andra skärmar gör det ingenting, eftersom de ber om ett val som en enda knapp inte kan göra.
Vad händer om en gäst trycker på fotobåsknappen två gånger?
Froozbooth räknar tryck med mindre än 400 ms emellan som ett, så en studsande kontakt eller ett snabbt dubbeltryck tar inte två foton. Ett tryck på en skärm som ber om ett val, som att välja ett läge, gör ingenting.
Vilka fotobåshändelser kan utlösa en webhook?
Froozbooth exponerar 17 händelser: sessionssteg (session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.canceled), utdata (print.sent, print.done, share.email.sent, share.qr.shown) och fel (error.capture, error.compose, error.print, error.camera, error.disk, error.license). Varje utlösare lyssnar bara på de händelser du väljer. Varje meddelande bär en formatversion, händelsens namn, en ISO 8601-tidsstämpel, sessions-, evenemangs- och maskin-id samt data som är specifika för händelsen.
Kan jag köra ett skript på båsets dator när ett foto tas?
Ja, med en programutlösare. Froozbooth startar en körbar fil på båsets dator vid de händelser du väljer, som shot.taken; den måste anges som en absolut sökväg och vara tillåten i hårdvarutjänstens tillåtelselista. Den får namngivna argument (--event, --session, --booth-event, --ts, --device), följda av händelsedata.
Hur testar jag en fotobåsutlösare innan gästerna kommer?
Använd Test-knappen i båsets administration: Froozbooth skickar en exempelhändelse och visar svaret. De senaste 200 utskicken loggas med status, kod och latens, och kan exporteras till CSV. En händelse som är äldre än 60 sekunder loggas i stället för att spelas upp igen, så en omstart utlöser inte en blixt mitt under middagen.
Kan fotobåset varna mig när skrivaren eller kameran fallerar?
Ja, med en utlösare på felhändelserna: error.print, error.camera, error.capture, error.compose, error.disk och error.license. Rikta den mot en webhook på din egen tjänst för att få varningen där du vill. Dashboardens sida Maskiner visar också varje båss status live, och du kan lägga till den på mobilens startskärm.