Voximplant allows users to record a video conference into a single video file. There are three modes of video conference recording: grid, tribune and custom. This article will help you to set up each mode.
In a video conference record, each participant's section appears and disappears automatically when the participant enters or leaves the conference. If any participant shares their screen, it appears as an additional section and disappears when the screen sharing ends. The length of the video equals the length of the whole conference.
How to create a video conference recording
To set up video conference recording, open your scenario and do the following.
- Add a recorder module to your scenario:
- Prepare recorder properties:
Please note the
videoopt parameter. This is the object that contains video options. Here are the most important parameters for video conference recording:
mixing: specifies whether to create a single file of conference recording
profile: specifies the video quality. Refer to the table below
background: specifies the HTML color code for the recording background
vad: specifies whether to highlight the borders of a speaking participant's frame
labels: specifies whether to show the participants' names on their frames
The available values for the profile option are (case sensitive):
You can specify the optional expire parameter (accepts one of the RecordExpireTime enumeration values) if you need to keep the video available for longer time (default is 3 months).
Increasing the expire parameter can cause extra charges. Find more information on your control panel's "Billing" section.
- Create a recorder instance with the prepared parameters:
- Send the conference object to the recorder via the SendMediaTo method:
After that, the conference starts recording. The recording is saved in the Voximplant cloud by default, but you can choose to save it in your own S3-compatible storage.
Please take a look at the example video conference scenario to understand how it works in detail:
After the conversation, the recorded video does not appear in your control panel immediately. It appears after some processing time, usually a 1/5 of the conference time.
AWS S3-compatible storage
By default, all records are saved in the Voximplant cloud storage. You can use your own AWS S3-compatible storage to store your records. To do so, follow the S3-compatible storage integration guide.
Video conference recording billing
When you record a conference, you pay for:
- Video recording
- Video composition and storage on AWS S3
The price for video composition and storage depends on two parameters: video quality and storage time. Please refer to your control panel's Billing section to find the price table on the video conference recording.