Pulsanti fisici: arcade, pedale, telecomando per presentazioni
Collega un pulsante via USB e funziona, senza impostazioni. Sulla schermata di benvenuto una pressione avvia la sessione; sull’anteprima dal vivo scatta la foto o ferma il video. Altrove non fa nulla: quelle schermate chiedono una scelta che un pulsante solo non può esprimere.
- Encoder da tastiera, pedali USB e telecomandi per presentazioni: Spazio, Invio, Pagina su e giù, frecce, da F13 a F15 o play/pausa.
- Encoder arcade “zero delay”, visti da Windows come un controller di gioco: qualsiasi pulsante.
- Due pressioni a meno di 400 ms contano come una: un contatto che rimbalza non scatta due foto.
Trigger: un webhook o un programma a ogni evento
Per tutto il resto ci sono i trigger. Ognuno si imposta nell’amministrazione della cabina, ascolta gli eventi scelti e chiama un URL o avvia un programma sul PC della cabina.
- WebhookUn POST HTTP con corpo JSON, firmato in HMAC-SHA256 con il tuo segreto. Intestazioni: X-Froozbooth-Event, X-Froozbooth-Timestamp, X-Froozbooth-Signature.
- ProgrammaUn eseguibile del PC della cabina, indicato con percorso assoluto e autorizzato nella lista consentita del servizio hardware. Argomenti con nome: --event, --session, --booth-event, --ts, --device e poi i dati dell’evento.
I 17 eventi che puoi ascoltare
- Sessione: session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.cancelled.
- Uscite: print.sent, print.done, share.email.sent, share.qr.shown.
- Errori: error.capture, error.compose, error.print, error.camera, error.disk, error.license.
Ogni messaggio contiene una versione del formato (v), il nome dell’evento, un timestamp ISO 8601, l’identificativo della sessione, quello dell’evento, quello della macchina e un oggetto data proprio dell’evento.
Pensato per una serata dal vivo
- Un trigger non rallenta mai la sessione: senza risposta entro 2 secondi, la cabina va avanti.
- Tre nuovi tentativi, dopo 0,5, 2 e 5 secondi. Più tardi, un flash arriverebbe dopo la posa.
- Un evento più vecchio di 60 secondi viene registrato, non ripetuto: dopo un riavvio, nessun lampo in mezzo alla cena.
- Un pulsante Prova invia un evento di prova e mostra la risposta, un’ora prima dell’apertura delle porte.
- Gli ultimi 200 invii vengono registrati con stato, codice e latenza, ed esportabili in CSV.
Ricette pronte
- Flash da studio all’inizio del conto alla rovescia, tramite un gateway DMX o Art-Net.
- Un impulso o un suono a ogni scatto.
- Ritorno alla luce d’ambiente a fine sessione, tramite un bridge Philips Hue.
Fotocamere, stampanti e PC: l’attrezzatura che Froozbooth pilota direttamente è nella pagina hardware. Software photo booth Canon e Nikon: fotocamere e stampanti compatibili
Domande frequenti
Un pulsante arcade funziona con Froozbooth?
Sì. Un encoder da tastiera o “zero delay” collegato via USB funziona senza configurazione: una pressione avvia la sessione sulla schermata di benvenuto e scatta la foto sull’anteprima dal vivo.
Froozbooth può pilotare luci DMX o una macchina del fumo?
Tramite un trigger. Froozbooth invia l’evento a un webhook o a un programma, e il tuo gateway DMX o Art-Net, il tuo bridge Hue o il tuo script pilota il dispositivo.
Come verifico che un webhook arrivi davvero dalla cabina?
Calcola l’HMAC-SHA256 del corpo grezzo della richiesta con il tuo segreto e confrontalo con l’intestazione X-Froozbooth-Signature. Il campo ts, dentro il corpo firmato, permette di rifiutare le richieste vecchie.
Un trigger lento può far aspettare gli ospiti?
No. Un trigger ha 2 secondi; poi la cabina va avanti e riprova in background.
Posso scattare con un pedale o un telecomando per presentazioni?
Sì. Froozbooth riconosce senza impostazioni i pedali USB e i telecomandi per presentazioni, purché inviino Spazio, Invio, Pagina su o giù, una freccia, da F13 a F15 o play/pausa. Una pressione avvia la sessione sulla schermata di benvenuto, e scatta la foto o ferma il video sull’anteprima dal vivo. Sulle altre schermate non fa nulla, perché chiedono una scelta che un pulsante solo non può esprimere.
Cosa succede se un ospite preme due volte il pulsante della cabina?
Froozbooth conta come una sola le pressioni a meno di 400 ms di distanza: un contatto che rimbalza o una doppia pressione veloce non scatta due foto. Una pressione su una schermata che chiede una scelta, come quella della modalità, non fa nulla.
Quali eventi della cabina possono attivare un webhook?
Froozbooth offre 17 eventi: le fasi della sessione (session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.cancelled), le uscite (print.sent, print.done, share.email.sent, share.qr.shown) e gli errori (error.capture, error.compose, error.print, error.camera, error.disk, error.license). Ogni trigger ascolta solo gli eventi che scegli. Ogni messaggio contiene una versione del formato, il nome dell’evento, un timestamp ISO 8601, gli identificativi di sessione, evento e macchina, e dati specifici dell’evento.
Posso eseguire uno script sul PC della cabina a ogni foto?
Sì, con un trigger di tipo programma. Froozbooth avvia un eseguibile del PC della cabina sugli eventi scelti, come shot.taken; va indicato con percorso assoluto e autorizzato nella lista consentita del servizio hardware. Riceve argomenti con nome (--event, --session, --booth-event, --ts, --device) e poi i dati dell’evento.
Come provo un trigger prima che arrivino gli ospiti?
Con il pulsante Test nell’amministrazione della cabina: Froozbooth invia un evento di esempio e mostra la risposta. Gli ultimi 200 invii sono registrati con stato, codice e latenza, ed esportabili in CSV. Un evento più vecchio di 60 secondi viene registrato, non ripetuto: dopo un riavvio, nessun flash a metà cena.
La cabina può avvisarmi se la stampante o la fotocamera si guastano?
Sì, con un trigger sugli eventi di errore: error.print, error.camera, error.capture, error.compose, error.disk ed error.license. Collegalo a un webhook del tuo servizio per ricevere l’avviso dove vuoi. La pagina Macchine della dashboard mostra anche lo stato di ogni cabina in tempo reale, e puoi aggiungerla alla schermata home del telefono.