Botões físicos: arcade, pedal, passador de slides
Ligue um botão por USB e ele funciona, sem ajustes. Na tela de boas-vindas, um toque inicia a sessão; na visualização ao vivo, tira a foto ou para o vídeo. Nas outras telas não faz nada: elas pedem uma escolha que um botão único não consegue expressar.
- Encoders de teclado, pedais USB e passadores de slides: Espaço, Enter, Page Up e Page Down, setas, F13 a F15 ou play/pause.
- Encoders arcade “zero delay”, que o Windows vê como um controle de jogo: qualquer botão.
- Dois toques com menos de 400 ms de intervalo contam como um: um contato que oscila não tira 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 escolhidos e chama uma URL ou inicia um programa no PC da cabine.
- WebhookUm POST HTTP com corpo JSON, assinado em HMAC-SHA256 com o seu segredo. Cabeçalhos: X-Froozbooth-Event, X-Froozbooth-Timestamp, X-Froozbooth-Signature.
- ProgramaUm executável do PC da cabine, indicado por caminho absoluto e autorizado na lista de permissões do serviço de hardware. Argumentos nomeados: --event, --session, --booth-event, --ts, --device e 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.cancelled.
- Saídas: 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 carimbo de data ISO 8601, o identificador da sessão, o do evento, o da máquina e um objeto data próprio do evento.
Feito para uma noite ao vivo
- Um gatilho nunca atrasa a sessão: sem resposta em 2 segundos, a cabine segue em frente.
- Três novas tentativas, após 0,5, 2 e 5 segundos. Mais tarde que isso, um flash cairia depois da pose.
- Um evento com mais de 60 segundos é registrado, não repetido: depois de reiniciar, nenhum flash no meio do jantar.
- Um botão Testar envia um evento de teste e mostra a resposta, uma hora antes de abrir 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 ponte 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 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 “zero delay” ligado 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 sua ponte Hue ou o seu script controla o aparelho.
Como verificar se um webhook vem mesmo 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 fazer os convidados esperarem?
Não. Um gatilho tem 2 segundos; depois disso, a cabine segue e tenta de novo em segundo plano.
Dá para tirar a foto com um pedal ou um passador de slides?
Sim. O Froozbooth reconhece sem configuração pedais USB e passadores de slides, desde que enviem Espaço, Enter, Page Up ou Page 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 para o vídeo na visualização ao vivo. Nas outras telas não faz nada, porque elas pedem uma escolha que um botão único não consegue expressar.
O que acontece se um convidado apertar o botão da cabine duas vezes?
O Froozbooth conta como um só os toques com menos de 400 ms de intervalo: um contato que oscila ou um toque duplo rápido não tira duas fotos. Um toque numa tela que pede uma escolha, como a do modo, não faz nada.
Quais eventos da cabine podem acionar um webhook?
O Froozbooth oferece 17 eventos: as etapas da sessão (session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.cancelled), as saídas (print.sent, print.done, share.email.sent, share.qr.shown) e os erros (error.capture, error.compose, error.print, error.camera, error.disk, error.license). Cada gatilho escuta só os eventos que você escolher. Cada mensagem traz uma versão de formato, o nome do evento, um carimbo de data ISO 8601, os identificadores de sessão, de evento e de máquina, e dados próprios do evento.
Dá para rodar um script no PC da cabine a cada foto?
Sim, com um gatilho do tipo programa. O Froozbooth inicia um executável do PC da cabine nos eventos escolhidos, como shot.taken; ele deve ser indicado por caminho absoluto e autorizado na lista de permissões do serviço de hardware. Ele recebe argumentos nomeados (--event, --session, --booth-event, --ts, --device) e depois os dados do evento.
Como testar um gatilho antes de os convidados chegarem?
Com o botão Test 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, não repetido: depois de reiniciar, nada de flash no meio do jantar.
A cabine pode me avisar quando a impressora ou a câmera falham?
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 do 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 pode ser adicionada à tela inicial do seu celular.