Updated on 2024-03-28 GMT+08:00

Constraints

Before using Live, understand the following constraints.

Resource Constraints

Table 1 describes the constraints.

Table 1 Usage restrictions

Item

Description

Region

Currently, Live is available only in AP-Bangkok, AP-Singapore, and CN North-Beijing4.

Domain name

By default, you can add a maximum of 64 domain names to each account.

If you want to livestream an event in the Chinese mainland or globally, ensure that the domain name to be added has been licensed by the Ministry of Industry and Information Technology (MIIT) and the ICP license is valid.

Concurrent live stream

There is no limit on the number of concurrent live streams. However, if you will have a large number of concurrent live streams, you are advised to submit a service ticket.

Stream pushing

There is no limit on the bitrate. Common resolutions and bitrates are supported. To ensure smooth streaming, it is recommended that the bitrate be no greater than 4 Mbit/s.

Playback

You can play a live stream only after ingest and streaming domain names have been associated and the values of AppName and StreamName in the streaming URL are the same as those in the ingest URL.

Input/Output format

Cloud Stream Live

  • Video packaging protocols
    • RTMP and FLV

      Video codec: H.264 and H.265, etc.

    • HLS output protocol

      Video codec: H.264 and H.265, etc.

  • Audio packaging protocols
    • RTMP and FLV

      Audio codec: AAC, etc.

    • HLS output protocol

      The supported audio encoding format is AAC.

Low Latency Live (LLL)

  • Transmission protocol requirements
    • Signaling transmission protocol: HTTPS, HTTP, and UDP are supported. HTTP listening port 80 is enabled. HTTP and UDP are insecure.
    • Media transmission protocol: UDP and TCP are supported. Media streams can be encrypted. It is recommended that DTLS be used for signaling negotiation, as UDP is insecure.
  • Encoding format requirements
    • Audience: The supported video encoding format is H.264 without B frames, and the supported audio encoding format is OPUS.
    • Streamer: The supported video encoding format is H.264 without B frames, and the supported audio encoding format is AAC (LC/HE).
NOTE:
  • If the format of the streaming end does not meet the requirements, you need to create a transcoding template. LLL supports real-time transcoding, and you will be billed for using this function. By default, the system supports the conversion from AAC to OPUS, and no fee is generated.
  • To achieve lower latency, you are advised to set the GOP at the streaming device to 2s.
  • The audio-only or video-only mode is not supported.

Streaming management

This function is available only in the AP-Singapore and CN North-Beijing4 regions.

Recording

This function is unavailable in the AP-Bangkok region.

Transcoding

In the AP-Bangkok region, submit a service ticket for review after configuring a template. The configuration takes effect only after it is approved.

Snapshot capturing

Stream status notifications

Content compliance

Live does not support the access of websites that violate related laws and regulations, including but not limited to:

  • Websites that contain pornographic content or content related to gambling, illegal drugs, frauds, or infringement
  • Gaming websites that run on illegal private servers
  • Websites that provide pirated games/software/videos
  • P2P lending websites
  • Unofficial lottery websites
  • Unlicensed hospital and pharmaceutical websites
  • Inaccessible websites or websites that do not contain any substantial information
NOTE:
  • If your acceleration domain name violates related laws and regulations, you shall bear the related risks.
  • If any pornographic content or content related to gambling, illegal drugs, or frauds is found on your domain name, the domain name and other domain names that use the same origin server will be deleted from Live and can no longer access Live. Acceleration domain name quota of the account will be reduced to 0.

API Constraints

The Live service sets a limit on the number of API calls to prevent service interruption caused by repeated API calls in a short period of time.

Table 2 API request throttling

API Category

API Name

Max. User Requests

Max. API Requests

Domain name management

  • Creating a domain name
  • Querying domain names

300 times/minute

3000 times/minute

  • Deleting a domain name
  • Modifying a domain name
  • Mapping domain names
  • Deleting a domain name mapping
  • Configuring the domain name IPv6 switch

100 times/minute

1000 times/minute

Transcoding template management

  • Creating a transcoding template
  • Deleting a transcoding template
  • Modifying a transcoding template
  • Querying transcoding templates

100 times/minute

1000 times/minute

Stream management

  • Disabling a push stream
  • Modifying the attribute of a disabled stream

4000 times/minute

12,000 times/minute

  • Resuming a push stream
  • Querying disabled streams

3000 times/minute

6000 times/minute

Querying ongoing streams

1000 times/minute

2000 times/minute

Access control

  • Querying the URL validation configuration of a specified domain name
  • Modifying the URL validation configuration of a specified domain name
  • Deleting the URL validation configuration of a specified domain name

150 times/minute

300 times/minute

Snapshot management

  • Creating a snapshot capturing template
  • Modifying a snapshot capturing template
  • Querying snapshot capturing templates
  • Deleting a snapshot capturing template

150 times/minute

300 times/minute

Log management

Obtaining livestreaming logs

300 times/minute

3000 times/minute

Recording management

  • Creating a recording template
  • Querying recording templates
  • Modifying a recording template
  • Deleting a recording template
  • Querying recording templates
  • Submitting a recording command

300 times/minute

3000 times/minute

Creating a video recording index

1200 times/minute

3000 times/minute

Recording callback management

  • Creating a recording callback
  • Querying recording callbacks
  • Modifying a recording callback
  • Querying recording callbacks
  • Deleting a recording callback

300 times/minute

300 times/minute

HTTPS certificate management

  • Modifying the HTTPS certificate configuration of a specified domain name
  • Querying the HTTPS certificate configuration of a specified domain name
  • Deleting the HTTPS certificate configuration of a specified domain name

150 times/minute

300 times/minute

OBS bucket management

Granting or canceling authorization of accessing OBS buckets

150 times/minute

300 times/minute

Statistical analysis

  • Querying the duration of transcoded outputs
  • Querying the number of recording channels
  • Querying the number of snapshots
  • Querying playback profiles

60 times/minute

5000 times/minute

  • Querying the peak bandwidth
  • Querying the total playback traffic
  • Querying HTTP status codes
  • Querying upstream bandwidth
  • Querying the number of stream push channels
  • Querying historical streams

20 times/minute

5000 times/minute

Querying the distribution of livestreaming metrics by region

50 times/second

150 times/second

Stream analytics

  • Querying the stream frame rate
  • Querying the stream bitrate

20 times/minute

5000 times/minute

Querying stream analytics

Once per second

5 times/second

Querying CDN upstream streaming quality data

60 times/second

300 times/second