Botões físicos: arcade, pedal, controle de apresentação
Conecte um botão por USB e ele funciona, sem nada para configurar. Na tela de boas-vindas, um toque inicia a sessão; na visualização ao vivo, tira a foto ou encerra o vídeo. Nas demais telas, não faz nada, porque elas pedem uma escolha que um único botão não consegue fazer.
- Encoders de teclado, pedais USB e controles de apresentação: Espaço, Enter, Page Up/Down, setas, F13 a F15 ou play/pause.
- Encoders arcade “zero delay”, vistos pelo Windows como um controle de jogo: qualquer botão.
- Toques com menos de 400 ms de intervalo contam como um só, para que um contato com repique não tire duas fotos.
Gatilhos: um webhook ou um programa a cada evento
Para todo o resto, existem os gatilhos. Cada um é configurado na administração da cabine, escuta os eventos que você escolher e chama uma URL ou inicia um programa no PC da cabine.
- WebhookUm HTTP POST com um corpo JSON, assinado com HMAC-SHA256 usando o seu segredo. Cabeçalhos: X-Froozbooth-Event, X-Froozbooth-Timestamp, X-Froozbooth-Signature.
- ProgramaUm executável no PC da cabine, indicado por um caminho absoluto e autorizado na lista de permissões do serviço de hardware. Argumentos nomeados: --event, --session, --booth-event, --ts, --device, depois os dados do evento.
Os 17 eventos que você pode escutar
- Sessão: session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.canceled.
- Saída: print.sent, print.done, share.email.sent, share.qr.shown.
- Erros: error.capture, error.compose, error.print, error.camera, error.disk, error.license.
Cada mensagem traz uma versão de formato (v), o nome do evento, um timestamp ISO 8601, o id da sessão, o id do evento, o id da máquina e um objeto de dados específico do evento.
Feito para uma noite ao vivo
- Um gatilho nunca atrasa a sessão: após 2 segundos sem resposta, a cabine segue em frente.
- Três novas tentativas, após 0,5, 2 e 5 segundos. Depois disso, um flash cairia depois da pose.
- Um evento com mais de 60 segundos é registrado, não reproduzido: após uma reinicialização, nenhum flash no meio do jantar.
- Um botão Testar envia um evento de exemplo e mostra a resposta, uma hora antes de abrirem as portas.
- Os últimos 200 envios ficam registrados com status, código e latência, e podem ser exportados em CSV.
Receitas prontas
- Flash de estúdio no início da contagem regressiva, por um gateway DMX ou Art-Net.
- Um pulso ou um som a cada foto.
- Volta à luz ambiente no fim da sessão, por uma bridge Philips Hue.
Câmeras, impressoras e PCs: o equipamento que o Froozbooth controla diretamente está na página de equipamentos. Software de cabine de fotos com DSLR Canon e Nikon: câmeras e impressoras compatíveis
Perguntas frequentes
Um botão arcade funciona com o Froozbooth?
Sim. Um encoder de teclado ou um encoder “zero delay” conectado por USB funciona sem configuração: um toque inicia a sessão na tela de boas-vindas e tira a foto na visualização ao vivo.
O Froozbooth pode controlar luzes DMX ou uma máquina de fumaça?
Por meio de um gatilho. O Froozbooth envia o evento a um webhook ou a um programa, e o seu gateway DMX ou Art-Net, a bridge Hue ou um script aciona o dispositivo.
Como confiro se um webhook realmente vem da cabine?
Calcule o HMAC-SHA256 do corpo bruto da requisição com o seu segredo e compare com o cabeçalho X-Froozbooth-Signature. O campo ts, dentro do corpo assinado, permite recusar requisições antigas.
Um gatilho lento pode deixar os convidados esperando?
Não. Um gatilho tem 2 segundos; passado esse prazo, a cabine segue em frente e tenta de novo em segundo plano.
Posso usar um pedal ou um controle de apresentação para tirar a foto?
Sim. O Froozbooth reconhece pedais USB e controles de apresentação sem configuração, desde que enviem Espaço, Enter, Page Up/Down, uma seta, F13 a F15 ou play/pause. Um toque inicia a sessão na tela de boas-vindas e tira a foto ou encerra o vídeo na visualização ao vivo. Nas outras telas, não faz nada, porque elas pedem uma escolha que um único botão não consegue fazer.
O que acontece se um convidado apertar o botão da cabine de fotos duas vezes?
O Froozbooth conta como um só os toques com menos de 400 ms de intervalo, então um contato com repique ou um duplo toque rápido não tira duas fotos. Um toque em uma tela que pede uma escolha, como a seleção de um modo, não faz nada.
Quais eventos da cabine de fotos podem acionar um webhook?
O Froozbooth expõe 17 eventos: etapas da sessão (session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.canceled), saídas (print.sent, print.done, share.email.sent, share.qr.shown) e erros (error.capture, error.compose, error.print, error.camera, error.disk, error.license). Cada gatilho escuta apenas os eventos que você escolher. Cada mensagem traz uma versão de formato, o nome do evento, um timestamp ISO 8601, os ids da sessão, do evento e da máquina, e dados específicos do evento.
Posso executar um script no PC da cabine quando uma foto é tirada?
Sim, com um gatilho de programa. O Froozbooth inicia um executável no PC da cabine nos eventos que você escolher, como shot.taken; ele precisa ser indicado por um caminho absoluto e autorizado na lista de permissões do serviço de hardware. Ele recebe argumentos nomeados (--event, --session, --booth-event, --ts, --device), seguidos dos dados do evento.
Como testo um gatilho da cabine de fotos antes da chegada dos convidados?
Use o botão Testar na administração da cabine: o Froozbooth envia um evento de exemplo e mostra a resposta. Os últimos 200 envios ficam registrados com status, código e latência, e podem ser exportados em CSV. Um evento com mais de 60 segundos é registrado em vez de reproduzido, então uma reinicialização não dispara um flash no meio do jantar.
A cabine de fotos pode me avisar quando a impressora ou a câmera falhar?
Sim, com um gatilho nos eventos de erro: error.print, error.camera, error.capture, error.compose, error.disk e error.license. Aponte-o para um webhook no seu próprio serviço para receber o alerta onde quiser. A página Máquinas do painel também mostra o status de cada cabine ao vivo, e você pode adicioná-la à tela inicial do seu celular.