camera_add_video_group_entry()

Updated: April 19, 2023

Associate a camera with a given video group

Synopsis:

#include <camera/camera_api.h>
camera_error_t camera_add_video_group_entry(camera_video_group_id_t group_id,
                                            camera_handle_t handle)

Arguments:

group_id
The ID of the video group (see camera_video_group_id_t).
handle
The handle of the camera to register with the group (see camera_handle_t).

Library:

libcamapi

Description:

This function registers the handle of a camera with a video group created using camera_create_video_group(). After the camera is registered, it becomes associated with the video group and camera_start_video() or camera_start_encode() no longer start video encoding right away. Instead, the video encoding waits until a call to camera_start_video_group(), which permits all cameras associated with the same video group to start recording or encoding video at the same time.

Returns:

CAMERA_EOK when the function successfully completes, otherwise another camera_error_t value that provides the reason that the call failed.