Video Layouts

Configure the video layout for your bot's final recording.

📘

Control the video layout

When calling Create Bot, you can control the view configuration by using the recording_config.video_mixed_layout parameter.

ParameterValuesDefault
recording_config.video_mixed_layoutspeaker_view\ gallery_view\ gallery_view_v2\ audio_onlyspeaker_view
recording_config.video_mixed_participant_video_when_screenshareoverlap\ beside\ hideoverlap

View


↔️

Screen share view

Flip through images to see different video_mixed_participant_video_when_screenshare modes in each layout.

Speaker View


Gallery View

📘

Gallery View doesn't support fallback frames (participant names on black screen) for participants who's cameras are off. To get the fallback frames, use Gallery View V2 instead


Gallery View V2


Audio-only recording

Set recording_config.video_mixed_layout to audio_only to exclude participant camera video and screen-share video from recording outputs and real-time video outputs. It also guarantee that video data is never captured or stored by Recall.ai.

With recording_config.video_mixed_layout: "audio_only" and each output configured:

OutputExpected result
Mixed MP4 recordingAudio with a black video track.
Mixed real-time stream (RTMP)Audio with a black video track.
Separate participant MP4 recordingsNo participant MP4 files are generated. If video_separate_mp4 is enabled, the artifact’s download URL returns an empty JSON list ([]) on successful completion.
Separate real-time streams (PNG/H.264)No video frame events emitted.
⚠️

audio_only is not supported for webex.

Only Google Meet, Zoom, and Microsoft Teams is supported at this time.

FAQ

Is there a maximum number of participants displayed in the recording when using gallery view?

Yes. When using both gallery_view or gallery_view_v2, the maximum number of participants shown in the final mp4 (or real-time video stream) is capped

  • Zoom: 16 participants
  • Google Meet: 16 participants
  • Microsoft Teams: 9 participants

This is dictated by meeting platform limitations, and thus cannot be overridden.



Did this page help you?