mobile.takeVideo

Lets the user take a video with the mobile device and returns the corresponding video identifier.

Syntax

ui.Interface.frontCall("mobile", "takeVideo",
  [], [path])
  1. path - Holds the device opaque path to the video.

Usage

When displaying the application a mobile device, the "takeVideo" front call invokes the mobile device's camera to let the user take a video and returns the local path/URL to the video on the mobile device.

Important:

To be usable with GBC, this front call needs a secure context / front-end connection, in addition to mobile device permissions, when required. A secure context is achieved by using the GAS via HTTPS, via localhost on the same machine, or running direct via GDC-UR. When using GDC-UR, additional security settings need to be enabled in the GDC configuration panel. See GDC documentation for more details.

On desktop, this front call will open the file selector, to chose a file from the storage unit.

If the photo is canceled by the user, the front call returns NULL.

Important:

For GMA / Android™, using the takeVideo front call needs the android.permission.CAMERA, android.permission.READ_EXTERNAL_STORAGE and android.permission.WRITE_EXTERNAL_STORAGE Dangerous Permissions to be specified when building the APK. See Android permissions for more details.

The value returned in the path variable contains a reference to the system location of the video on the mobile device. This path is platform dependent, and may change in future versions. Consider the path returned by this front call as an opaque local file identifier, and do not use this path as a persistent filename for the video.

Once the video identifier/path is known, it is possible to fetch the video file from the device to the program context with the fgl_getfile() API. The procedure is similar to fetching photos from the device. For more details, see the section about video handling on mobile devices.

To play the video, you can perform a "launchURL" front call, with the opaque path returned by this front call.