Recording a live stream encapsulates the stream content into a video file in a specific format. Based on where you intend to save the recording file, Agora provides the following recording modes:
This page introduces how to use these recording modes.
If your Agora project (as identified by the App ID) has multiple entry points, their recording behavior must be consistent.
For example, for an Agora project that has two entry points (A and B), only the following cases are supported:
Entry point A | Entry point B |
---|---|
Enable standard recording for all live streams | Enable standard recording for all live streams |
Enable custom recording for all live streams | Enable custom recording for all live streams |
Enable standard recording for certain live streams | Enable standard recording for certain live streams |
Enable custom recording for certain live streams | Enable custom recording for certain live streams |
Depending on your business scenario, recording configurations can vary by entry point.
Call the Set standard recording configuration API. If the call is successful, standard recording is automatically enabled for all live streams under the entry point.
Call the Set custom recording configuration API. If the call is successful, custom recording is automatically enabled for all live streams under the entry point.
In some scenarios, you might only need to record some of the live streams under an entry point. To this end, you need to disable the current recording of all live streams under the entry point, and then enable recording for each live stream.
The action of enabling recording for a live stream remains effective for 24 hours. The following figure shows an example of how enabling recording interacts with various live streams:
The recording result of each stream is as follows:
Follow these steps to enable standard recording for a live stream:
enabled
to false
, which disables the current standard recording for the entry point.Follow these steps to enable custom recording for a live stream:
enabled
to false
, which disables the current custom recording for the entry point.