LVB Recording

Last updated: 2020-11-13 14:54:26

    LVB supports recording live streams and storing recording files in VOD for download and preview. This document describes how to create, modify, and delete recording templates.
    You can create a recording template in the following two methods:


    • The recorded video files are stored in the VOD Console by default. You are recommended to activate the VOD service in advance and purchase appropriate resource packages so as to avoid service suspension due to account arrears. For more information, please see Getting Started with VOD.
    • After enabling the recording feature, please make sure that your VOD service is in normal status; if it has not been activated or has been suspended due to account arrears, LVB recording will not be available, no recording files will be generated, and no recording fees will be incurred.
    • During the live streaming, you can get a recording file in about 5 minutes after the recording process ends. For example, if you start recording a live stream at 12:00, you can get the corresponding clip for 12:00 to 12:30 at around 12:35.
    • Subject to the audio and video file formats (FLV/MP4/HLS), the video encoding format of H.264 and audio encoding format of ACC are supported.
    • After a recording template is created successfully, it can be associated with a push domain name. For more information, please see Recording Configuration. The association will take effect in about 5–10 minutes.
    • For more information about the recording filenames, see the VodFileName parameter in Data Types.


    Creating Recording Template

    1. Log in to the LVB Console and go to Feature Configuration > LVB Recording.

    2. Click + to set basic information and configure as follows:

      Configuration ItemConfiguration Description
      Default template Default template type for LVB recording, which can be FLV, MP4, or HLS.
      Template name Custom LVB recording template name, which can contain letters, digits, underscores, and hyphens.
      Template description Custom LVB recording template description, which can contain letters, digits, underscores, and hyphens.
      Recording file type Videos are recorded based on the original bitrate of the live stream and can be output in .hls, .mp4, .flv, and .aac formats. The .aac format records the audio only.
      Length of a single recording file (in minutes)
      • There is no upper limit for HLS format. If a file exceeds the recording resumption timeout period, a new file will be created to continue recording.
      • The length of a single file recorded in .mp4, .flv, or .aac format ranges from 5 to 120 minutes.
      File retention duration (in days) A single recording file can be retained for up to 1,080 days. A retention period of 0 means "never expire".
      Recording resumption timeout period (in seconds) Only the .hls format supports recording resumption after push interruption, and the timeout period for resumption can be set between 0 and 1,800 seconds.
      Recording to subapplication Live streams can be recorded to a specified subapplication in VOD. They are recorded to the primary application under the account by default. Only writable subapplications are supported.
    3. Click Save.

    Modifying Recording Template

    1. Select Feature Configuration > LVB Recording.
    2. Select the target recording template and click Edit on the right to modify the template information.
    3. Click Save.

    Deleting Recording Template

    1. Select Feature Configuration > LVB Recording.
    2. Select the target recording template and click above.
    3. Confirm whether to delete the selected recording template and click OK to delete it.


    The recording templates are managed at the domain name level in the console, and rules created by APIs cannot be canceled there for the time being. If you associated the recording configuration with a specified stream through the recording management API and want to disassociate them, you need to call the DeleteLiveRecordRule API.

    Associating and Disassociating Push Domain Name

    For detailed directions, please see Recording Configuration.


    How will the video be named after LVB recording?

    According to the recording template created on LVB Console, a recording file generated after callback will be named by the default format:

    Placeholder Description
    {StreamID} Stream ID
    {StartYear} Start time-Year
    {StartMonth} Start time-Month
    {StartDay} Start time-Day
    {StartHour} Start time-Minute
    {StartMinute} Start time-Minute
    {StartSecond} Start time-Second
    {EndYear} End time-Year
    {EndMonth} End time-Month
    {EndDay} End time-Day
    {EndHour} End time-Minute
    {EndMinute} End time-Minute
    {EndSecond} End time-Second

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback