물리 버튼｜아케이드, 페달, 프레젠터 리모컨
버튼을 USB로 연결하면 설정 없이 바로 작동합니다. 시작 화면에서 누르면 세션이 시작되고, 라이브 뷰에서 누르면 사진을 찍거나 영상을 멈춥니다. 그 밖의 화면에서는 버튼 하나로 할 수 없는 선택을 요구하므로 아무 일도 일어나지 않습니다.
- 키보드 인코더, USB 페달, 프레젠터 리모컨: Space, Enter, Page Up/Down, 방향키, F13~F15 또는 재생/일시정지.
- Windows에서 게임 컨트롤러로 인식되는 “제로 딜레이” 아케이드 인코더: 모든 버튼.
- 400 ms 이내의 입력은 한 번으로 계산하므로 접점이 튀어도 사진이 두 장 찍히지 않습니다.
트리거｜모든 이벤트에 웹훅이나 프로그램 연결
그 밖의 모든 경우에는 트리거를 쓰십시오. 트리거는 부스 관리자 화면에서 설정하고, 선택한 이벤트를 감지해 URL을 호출하거나 부스 PC의 프로그램을 실행합니다.
- 웹훅사용자의 시크릿으로 HMAC-SHA256 서명한 JSON 본문의 HTTP POST입니다. 헤더는 X-Froozbooth-Event, X-Froozbooth-Timestamp, X-Froozbooth-Signature입니다.
- 프로그램부스 PC의 실행 파일로, 절대 경로로 지정하며 하드웨어 서비스 허용 목록에 등록되어야 합니다. 명명된 인수는 --event, --session, --booth-event, --ts, --device이고 그 뒤에 이벤트 데이터가 옵니다.
감지할 수 있는 17개 이벤트
- 세션: session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.canceled.
- 출력: print.sent, print.done, share.email.sent, share.qr.shown.
- 오류: error.capture, error.compose, error.print, error.camera, error.disk, error.license.
각 메시지에는 형식 버전(v), 이벤트 이름, ISO 8601 타임스탬프, 세션 ID, 이벤트 ID, 기기 ID, 그리고 이벤트별 데이터 객체가 담겨 있습니다.
실전 현장을 위한 설계
- 트리거는 세션을 지연시키지 않습니다. 2초 안에 응답이 없으면 부스는 다음으로 넘어갑니다.
- 재시도는 3회이며 0.5초, 2초, 5초 뒤에 합니다. 그보다 늦으면 플래시가 포즈 뒤에 터지게 됩니다.
- 60초보다 오래된 이벤트는 다시 보내지 않고 기록만 합니다. 재부팅 후에 저녁 식사 도중 플래시가 터지는 일이 없습니다.
- 테스트 버튼은 행사장 문을 열기 한 시간 전에 샘플 이벤트를 보내고 응답을 보여 줍니다.
- 최근 200건의 전송이 상태, 코드, 지연 시간과 함께 기록되며 CSV로 내보낼 수 있습니다.
바로 쓸 수 있는 구성 예시
- DMX 또는 Art-Net 게이트웨이를 통해 카운트다운 시작 시 스튜디오 플래시 작동.
- 촬영할 때마다 펄스나 소리 출력.
- Philips Hue 브리지를 통해 세션 종료 시 주변 조명으로 복귀.
카메라, 프린터, PC: Froozbooth가 직접 제어하는 하드웨어는 하드웨어 페이지에 있습니다. Canon, Nikon DSLR 포토부스 소프트웨어: 사용 가능한 카메라와 프린터
자주 묻는 질문
아케이드 버튼을 Froozbooth와 함께 쓸 수 있나요?
네. USB로 연결한 키보드 인코더나 “제로 딜레이” 인코더는 설정 없이 작동합니다. 시작 화면에서 누르면 세션이 시작되고, 라이브 뷰에서 누르면 사진이 찍힙니다.
Froozbooth로 DMX 조명이나 포그 머신을 제어할 수 있나요?
트리거를 통해 가능합니다. Froozbooth가 이벤트를 웹훅이나 프로그램으로 보내면, DMX 또는 Art-Net 게이트웨이, Hue 브리지, 스크립트가 장치를 구동합니다.
웹훅이 정말 부스에서 온 것인지 어떻게 확인하나요?
요청 원본 본문에 시크릿으로 HMAC-SHA256을 계산해 X-Froozbooth-Signature 헤더와 비교하십시오. 서명된 본문 안의 ts 필드로 오래된 요청을 거부할 수 있습니다.
느린 트리거 때문에 참석자가 기다리게 되나요?
아니요. 트리거에는 2초가 주어지며, 그 이후에는 부스가 계속 진행하고 백그라운드에서 재시도합니다.
풋 페달이나 프레젠터 리모컨으로 사진을 찍을 수 있나요?
네. Space, Enter, Page Up/Down, 방향키, F13~F15 또는 재생/일시정지를 보내는 USB 페달과 프레젠터 리모컨은 설정 없이 인식됩니다. 시작 화면에서 누르면 세션이 시작되고, 라이브 뷰에서 누르면 사진을 찍거나 영상을 멈춥니다. 다른 화면에서는 버튼 하나로 할 수 없는 선택을 요구하므로 아무 일도 일어나지 않습니다.
참석자가 포토부스 버튼을 두 번 누르면 어떻게 되나요?
Froozbooth는 400 ms 이내의 입력을 한 번으로 계산하므로, 접점이 튀거나 빠르게 두 번 눌러도 사진이 두 장 찍히지 않습니다. 모드 선택처럼 선택을 요구하는 화면에서 누르는 입력은 아무 일도 하지 않습니다.
어떤 포토부스 이벤트가 웹훅을 작동시킬 수 있나요?
Froozbooth는 17개 이벤트를 제공합니다. 세션 단계(session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.canceled), 출력(print.sent, print.done, share.email.sent, share.qr.shown), 오류(error.capture, error.compose, error.print, error.camera, error.disk, error.license)입니다. 각 트리거는 선택한 이벤트만 감지합니다. 모든 메시지에는 형식 버전, 이벤트 이름, ISO 8601 타임스탬프, 세션, 이벤트, 기기 ID, 이벤트별 데이터가 담겨 있습니다.
사진이 찍힐 때 부스 PC에서 스크립트를 실행할 수 있나요?
네, 프로그램 트리거로 가능합니다. Froozbooth는 선택한 이벤트(예: shot.taken)가 발생할 때 부스 PC의 실행 파일을 시작합니다. 절대 경로로 지정해야 하며 하드웨어 서비스 허용 목록에 등록되어야 합니다. 명명된 인수(--event, --session, --booth-event, --ts, --device)와 그 뒤에 이벤트 데이터를 받습니다.
참석자가 오기 전에 포토부스 트리거를 어떻게 테스트하나요?
부스 관리자 화면의 테스트 버튼을 사용하십시오. Froozbooth가 샘플 이벤트를 보내고 응답을 보여 줍니다. 최근 200건의 전송이 상태, 코드, 지연 시간과 함께 기록되며 CSV로 내보낼 수 있습니다. 60초보다 오래된 이벤트는 다시 보내지 않고 기록만 하므로, 재부팅해도 저녁 식사 도중 플래시가 터지지 않습니다.
프린터나 카메라에 문제가 생기면 포토부스가 알려 줄 수 있나요?
네, 오류 이벤트(error.print, error.camera, error.capture, error.compose, error.disk, error.license)에 트리거를 설정하십시오. 자체 서비스의 웹훅을 지정하면 원하는 곳에서 알림을 받을 수 있습니다. 대시보드의 기기 페이지에서도 각 부스의 상태를 실시간으로 볼 수 있으며, 휴대폰 홈 화면에 추가할 수 있습니다.