takeVideo
Lets the user take a video with the mobile device and returns the corresponding video identifier.
Syntax
ui.Interface.frontCall("mobile", "takeVideo",
[], [path])
- path - Holds the device opaque path to the video.
Usage
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.
If the photo is canceled by the user, the front call returns NULL
.
takeVideo
front call needs the
android.permission.CAMERA
,
android.permission.READ_EXTERNAL_STORAGE
and
android.permission.WRITE_EXTERNAL_STORAGE
Dangerous Permission 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 file name 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.