Botones físicos: arcade, pedal, mando de presentación
Conecta un botón por USB y funciona, sin ajustes. En la pantalla de bienvenida, una pulsación arranca la sesión; en la vista en directo, hace la foto o detiene el vídeo. En el resto no hace nada: esas pantallas piden una elección que un botón único no puede expresar.
- Codificadores de teclado, pedales USB y mandos de presentación: Espacio, Intro, Av Pág y Re Pág, flechas, F13 a F15 o reproducir/pausa.
- Codificadores arcade «zero delay», que Windows ve como un mando de juego: cualquier botón.
- Dos pulsaciones con menos de 400 ms de diferencia cuentan como una: un contacto que rebota no hace dos fotos.
Disparadores: un webhook o un programa en cada evento
Para todo lo demás están los disparadores. Cada uno se configura en la administración de la cabina, escucha los eventos que elijas y llama a una URL o lanza un programa en el PC de la cabina.
- WebhookUn POST HTTP con cuerpo JSON, firmado con HMAC-SHA256 y tu secreto. Cabeceras: X-Froozbooth-Event, X-Froozbooth-Timestamp, X-Froozbooth-Signature.
- ProgramaUn ejecutable del PC de la cabina, indicado con ruta absoluta y autorizado en la lista blanca del servicio de hardware. Argumentos con nombre: --event, --session, --booth-event, --ts, --device y después los datos del evento.
Los 17 eventos que puedes escuchar
- Sesión: session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.cancelled.
- Salidas: print.sent, print.done, share.email.sent, share.qr.shown.
- Errores: error.capture, error.compose, error.print, error.camera, error.disk, error.license.
Cada mensaje lleva una versión de formato (v), el nombre del evento, una marca de tiempo ISO 8601, el identificador de sesión, el del evento, el de la máquina y un objeto data propio del evento.
Pensado para una noche en directo
- Un disparador nunca retrasa la sesión: sin respuesta a los 2 segundos, la cabina sigue.
- Tres reintentos, a los 0,5, 2 y 5 segundos. Más tarde, un flash llegaría después de la pose.
- Un evento de más de 60 segundos se registra, no se repite: tras un reinicio, ningún destello en mitad de la cena.
- Un botón Probar envía un evento de prueba y muestra la respuesta, una hora antes de abrir las puertas.
- Los últimos 200 envíos quedan registrados con estado, código y latencia, y se exportan en CSV.
Recetas listas para usar
- Flash de estudio al empezar la cuenta atrás, mediante una pasarela DMX o Art-Net.
- Un impulso o un sonido en cada foto.
- Vuelta a la luz ambiente al terminar la sesión, mediante un puente Philips Hue.
Cámaras, impresoras y PC: el equipo que Froozbooth controla directamente está en la página de equipos. Software de fotomatón Canon y Nikon: cámaras e impresoras compatibles
Preguntas frecuentes
¿Funciona un botón arcade con Froozbooth?
Sí. Un codificador de teclado o «zero delay» conectado por USB funciona sin configuración: una pulsación arranca la sesión en la pantalla de bienvenida y hace la foto en la vista en directo.
¿Puede Froozbooth controlar luces DMX o una máquina de humo?
Mediante un disparador. Froozbooth envía el evento a un webhook o a un programa, y tu pasarela DMX o Art-Net, tu puente Hue o tu script controla el aparato.
¿Cómo compruebo que un webhook viene de verdad de la cabina?
Calcula el HMAC-SHA256 del cuerpo bruto de la petición con tu secreto y compáralo con la cabecera X-Froozbooth-Signature. El campo ts, dentro del cuerpo firmado, permite rechazar peticiones antiguas.
¿Un disparador lento puede hacer esperar a los invitados?
No. Un disparador tiene 2 segundos; después, la cabina sigue y reintenta en segundo plano.
¿Puedo hacer la foto con un pedal o un mando de presentación?
Sí. Froozbooth reconoce sin configuración los pedales USB y los mandos de presentación, siempre que envíen Espacio, Intro, Av Pág o Re Pág, una flecha, F13 a F15 o reproducir/pausa. Una pulsación arranca la sesión en la pantalla de bienvenida, y hace la foto o detiene el vídeo en la vista en directo. En las demás pantallas no hace nada, porque piden una elección que un botón único no puede expresar.
¿Qué pasa si un invitado pulsa dos veces el botón del fotomatón?
Froozbooth cuenta como una sola las pulsaciones con menos de 400 ms de diferencia: un contacto que rebota o una doble pulsación rápida no hace dos fotos. Una pulsación en una pantalla que pide una elección, como la del modo, no hace nada.
¿Qué eventos del fotomatón pueden activar un webhook?
Froozbooth ofrece 17 eventos: los pasos de la sesión (session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.cancelled), las salidas (print.sent, print.done, share.email.sent, share.qr.shown) y los errores (error.capture, error.compose, error.print, error.camera, error.disk, error.license). Cada disparador solo escucha los eventos que elijas. Cada mensaje lleva una versión de formato, el nombre del evento, una marca de tiempo ISO 8601, los identificadores de sesión, evento y máquina, y datos propios del evento.
¿Puedo ejecutar un script en el PC de la cabina al hacer cada foto?
Sí, con un disparador de tipo programa. Froozbooth lanza un ejecutable del PC de la cabina en los eventos que elijas, como shot.taken; debe indicarse con ruta absoluta y estar autorizado en la lista blanca del servicio de hardware. Recibe argumentos con nombre (--event, --session, --booth-event, --ts, --device) y después los datos del evento.
¿Cómo pruebo un disparador antes de que lleguen los invitados?
Con el botón Test de la administración de la cabina: Froozbooth envía un evento de ejemplo y muestra la respuesta. Los últimos 200 envíos quedan registrados con estado, código y latencia, y se exportan a CSV. Un evento de más de 60 segundos se registra, no se repite: tras un reinicio, ningún flash en mitad de la cena.
¿Puede el fotomatón avisarme si falla la impresora o la cámara?
Sí, con un disparador sobre los eventos de error: error.print, error.camera, error.capture, error.compose, error.disk y error.license. Apúntalo a un webhook de tu propio servicio para recibir el aviso donde quieras. La página Máquinas del panel también muestra el estado de cada cabina en directo, y puedes añadirla a la pantalla de inicio de tu móvil.