Start recording video.
camera_error_t camera_start_video(camera_handle_t handle, const char *filename, void(*video_callback)(camera_handle_t, camera_buffer_t *, void *), void(*status_callback)(camera_handle_t, camera_devstatus_t, uint16_t, void *), void *arg)
The handle returned by a call to the camera_open() function.
The name of the file to save the video to.
A function pointer to a function with the following signature: void function_name( camera_handle_t, camera_buffer_t*, void*). The function is a callback function to invoke when the uncompressed video frame is available. You can use NULL if no function needs to be called. For information about the callback arguments, see About callback mode.
A function pointer to a function with the following signature: void function_name(camera_handle_t, camera_devstatus_t, uint16_t, void*). The function is a callback that gets invoked when status events occur. You can use NULL if no function needs to be called. For information about the callback arguments, see About callback mode.
The argument passed to all callback functions, which is the last argument in the callback functions.
Video is recorded based on the configured properties. You must use the camera_start_video_viewfinder() to start the viewfinder before you call this function. The audio track will be taken from the active audio input on the device.
The Camera library does not automatically play audible shutter sounds when a picture is taken or a video is recorded. Camera applications must supply their own sound when a photo is captured or a video recording begins and ends. While you can choose to not have a shutter sound when taking a picture — you are responsible to ensure that the application adheres to the local laws of the regions in which you wish to distribute the application.
For example, it is illegal to mute or modify the shutter sound of a camera application in Japan and Korea. Ensure that you comply with the laws and regulations for the countries in which you distribute your application. For more information, see the BlackBerry World Vetting Criteria at https://appworld.blackberry.com/isvportal/home.do.
Before calling this function, call the camera_set_video_property() function to ensure that all required properties are set.
Last modified: 2013-12-21