Survey Screens
Survey screens are shown at the start of the photo booth shooting sequence, before the photos are taken. They can collect guest information such as name, email address, consent checkboxes, age verification, or custom choices.
To enable surveys:
- Open Touchscreen Settings and enable User survey screens.
- Create the survey definition files in the photo booth images folder.
Adding a survey screen
Click the Test keyboard… button in Touchscreen Settings and select Add survey keyboard… to open the Add Survey Keyboard dialog.
Checkboxes
Select Add checkbox to add a checkbox. Set an id (e.g. gallery) and a caption (e.g. “Display your photo in the online gallery”). Select Mandatory if the checkbox must be ticked before the user can continue.
Radio buttons
Select Add Radio Buttons to add a group of mutually exclusive options. Set a group name (e.g. gender) and option labels (e.g. “Male”, “Female”, “Rather not say”).
Text entry
Set the Text entry dropdown to one of:
- none — no text field
- normal — free text entry
- email — validates email format
- autoemail — validates email and automatically sends the output to the guest
Set an id and caption. Select Mandatory if text is required before continuing.
Age Gate
To enforce a minimum age, set the input id to age18 (or another number) to require date of birth entry in YYYYMMDD format. Use ageinyears18 to accept a plain age number instead.
If the guest is too young, display age_too_young.jpg. For format errors, display age_error.jpg.
Info screen
Select Add info screen to provide a button that displays an information page (e.g. terms and conditions or a privacy policy). This creates survey1_keyboard_info.jpg, which you edit in an image editor.
Survey data tokens
Survey responses can be used in print captions and folder paths using tokens. If a text field has id name on survey screen 2, its token is {survey2_text_name}. For a checkbox with id over21 on screen 1, the token is {survey1_chkbox_over21} (returns 1 if checked, 0 if not).
Combine with conditional logic: {if,{survey1_chkbox_over21},Alcoholic cocktail voucher,Soft drinks voucher}
Saved survey data format
Survey responses are stored in the XML photo booth summary file in the <survey_data> block:
<survey1_chkbox1 id="over21">0</survey1_chkbox1>
<survey1_chkbox2 id="agree">1</survey1_chkbox2>
<survey2_text1 id="name">Jane Smith</survey2_text1>
Making survey data available to other apps
To expose survey data to external applications via the Windows registry, set:
HKEY_CURRENT_USER\SOFTWARE\BreezeSystems\DSLRRemotePro\100\WriteSurveyDataToRegistry = 1
Responses are then written as a JSON string to:
HKEY_CURRENT_USER\SOFTWARE\BreezeSystems\Event Info\SurveyData
Automatically sending emails
Set the text input id to autoEmail to automatically send the photo booth output to the email address entered by the guest when the sharing screen is displayed.