Layer 4 contains the specifications for blocks that represent functionality specific to using a flow player on a smart device (e.g. smart phone, tablet).
Support for this layer should be implemented by all engines that target the OFFLINE channel. These blocks may make use of the Expression Specification for generating output.
The timeout in seconds that is a maximum that the device should wait for the required accuracy.
OFFLINE: This block first queries the device's in-built GPS capability to return the current GPS location of the device. If the device is not GPS capable, the block presents the user with a map and waits for them to choose their location. If the device is GPS capable but location services are disabled, the device may prompt the user to enable location services. This block then waits to receive a location via manual selection or from the location service that meets the accuracy threshold. (No selection provided or unable to capture the required accuracy: proceed through the default exit.)
RICH_MESSAGING: This block prompts the Contact for permission to access their location from their device, or choose a location manually, and waits for a compatible response. (No selection provided or unable to capture the required accuracy: proceed through the default exit.)
This block writes the location coordinates to the output variable corresponding to the name of the block. The format of the coordinates is an array of 4 floating point numbers: latitude, longitude, elevation (in meters), and accuracy (in meters):
[lat, long, elevation, accuracy]
[52.0835780,-106.6104880, 501.23, 0.5]
Photo Response Block
Suggested number of exits: 1 + default exit (used in case of error or invalid input)
Supported channels: OFFLINE
The prompt to be presented to contacts to ask for the image. This is a localized resource; it supports parsing of expressions in rendering.
OFFLINE, RICH_MESSAGING: This block first prompts the user to activate the camera on the device and waits for the user to take a picture, or select a saved picture on the device. (No picture selected or captured: proceed through the default exit.)
This block writes the ID of the captured media to the output variable corresponding to the name of the block.