Entering Event Codes
keyboard_sync – keyboard displayed in response to the “enter code then sync” touchscreen actions
For some applications such as unattended rental photo booths it is useful to be able to enter a code to select a particular event. To do this define a sync keyboard (keyboard_sync.xml) and use the syncCodeFromReady, menu1SyncCode or menu2SyncCode touchscreen actions. The sync code touchscreen actions will display the keyboard_sync keyboard to allow the user to enter a code and then update the current event. The code entered by the user can be accessed using the {syncCode} token and this can be used in the event server URL (e.g. https://bb4ipad.com/sync/code/{syncCode}) to select a different download URL or in the Dropbox prefix if syncing via Dropbox to select a different download path.
The easiest way to see how this works is to run the demo example. This can be loaded by setting the event server URL to:
https://bb4ipad.com/sync/code
sync_code_example_settings
Then go to the events screen and tap “Update all events” in the bottom right hand corner. This will download an event which has a sync keyboard for the user to enter an event code. It also downloads a device_settings.xml file which sets everything up for using event codes by changing a few settings on the iPad:
<?xml version="1.0" encoding="ISO-8859-1"?>
<breeze_booth build="1" version="1.0.2">
<device_settings>
<syncServer>https://bb4ipad.com/sync/code/{syncCode}</syncServer>
<syncServerPost>false</syncServerPost>
<syncViaDropbox>false</syncViaDropbox>
<syncCode>000000</syncCode>
</device_settings>
</breeze_booth>
The device_settings.xml file sets the sync server URL to https://bb4ipad.com/sync/code/{syncCode}. This will download events from a subfolder of https://bb4ipad.com/sync/code using the sync code entered by the user.
The device_settings.xml file also disables sync via HTTPS POST or Dropbox and sets the initial sync code to 000000 which is the event code used for entering sync codes in the example.
The example defines three folders of events:
- https://bb4ipad.com/sync/code/000000 — this event displays a start screen with no live view and a single button to enter an event code
- https://bb4ipad.com/sync/code/123456 — this event is a simple single photo setup with the print showing the event name as 123456
- https://bb4ipad.com/sync/code/654321 — this event is a simple single photo setup with the print showing the event name as 654321
Run the event and enter 123456 for the event code and it will load event #123456. Tap the gear icon in the top right hand corner to enter a new event code and either enter 000000 to go back to the initial event or 654321 to load event 654321. An error message is displayed if an invalid event code is entered.
Post your comment on this topic.