Console configuration

Add an ingest domain

1. In the navigation pane on the left, choose Domains. On the Domain Management page, click Add Domain.

2. Configure the parameters to add your domain.

   1. For Domain Type, select Ingest Domain.

   2. For information about how to select an acceleration region, see Select an acceleration region for a domain name.

   3. For Domain Name, enter your ingest domain.

   4. For information about how to select a live center, see Select a live center.

   Important

   The ingest domain and streaming domain must be in the same live center region. This setting cannot be changed after the initial configuration.

   Note

   When adding a domain to ApsaraVideo Live for the first time, you must verify its ownership by following the on-screen prompts. For more information, see Verify domain ownership.

3. Click Next and follow the prompts to configure a CNAME record. This record directs user traffic to live streaming nodes for accelerated access.

   DNS changes can take 5 to 10 minutes to propagate. After the verification is successful, Configured is displayed next to your ingest domain.

Your ingest domain is now configured. The result on the console is shown below.

On the Domain Management page, the Status of the ingest domain is Running.

View authentication key

The URL authentication feature protects your content from unauthorized access and piracy. This feature is enabled by default when you add a domain.

1. On the ApsaraVideo Live console, go to the Domains page. Find your ingest domain and click Configure in the Actions column.

2. Choose Stream Management > Access Control.

3. Find and record the primary key of your ingest domain for your server-side deployment.

   On the URL Authentication tab, you can view the primary key in the Authentication URL Settings section.

Add streaming domain

Adding a streaming domain follows the same steps as adding an ingest domain. The only difference is that you must set Domain Type to Streaming Domain.

In the domain list, the streaming domain shows a CNAME Status of Configured, a Live Center of China (Shenzhen), and a Status of Running.

View authentication key

URL authentication is enabled by default. Record and save the authentication primary key for the streaming domain. The steps are the same as for viewing the authentication key for the ingest domain.

Associate ingest domain

Next, associate the ingest domain with the corresponding streaming domain.

1. In the left-side navigation pane, choose Domains.

2. In the Domain Management list, find your target streaming domain and click Domain Settings.

3. Navigate to Stream Management > Basic Settings, click the Ingest Information tab, and then click Add Ingest Information.

4. Select the prepared ingest domain from the same live center, and click OK.

On the Ingest Information tab, you can view the associated ingest domain, CNAME, ingest protocols (RTMP and RTS are supported by default), ingest URL, and ingest callback URL.

Configure CORS

Cross-Origin Resource Sharing (CORS) is a standard HTML5 solution that allows a web page to load and access resources from a different origin. This enables secure cross-origin data transfer. For more information, see Cross-Origin Resource Sharing.

1. In the left-side navigation pane, choose Domains.

2. In the Domain Management list, find your target streaming domain and click Domain Settings.

3. Navigate to Stream Management > HTTP Header Configuration and click Add.

4. Set the parameter to Access-Control-Allow-Origin and the value to *.

For detailed instructions, see Configure HTTP headers.

Enable HTTPS

Configuring HTTPS acceleration encrypts critical user information during transmission. This prevents security risks such as sensitive information leakage caused by the interception of session IDs or cookies. It also ensures data integrity during transmission, preventing man-in-the-middle (MITM) attacks like DNS or content hijacking and tampering. For instructions, see Configure HTTPS secure acceleration.

In the left-side navigation pane, choose HTTPS. In the HTTPS Certificate section on the right, the certificate switch is enabled and displays details such as the Certificate Type (for example, Cloud Shield certificate), Certificate Name, Certificate Brand, and Expiration Time.

Configure transcoding template

Live transcoding resolves playback issues, such as poor quality and video stuttering, that are caused by excessively high or low bitrates from the ingest source. For details on how to configure standard transcoding, see Configure standard transcoding.

Activate RTS

Real-time Streaming (RTS) is a value-added feature of ApsaraVideo Live that provides a live video service with easy client access, ultra-low latency, high concurrency, and smooth HD streaming. For an overview, see Real-time Streaming (RTS).

1. Log on to the ApsaraVideo Live console.

2. In the navigation pane on the left, choose Feature Center > RTS.

3. Select a streaming domain.

4. Turn on the RTS switch and select Sub-second Latency (700ms-900ms end-to-end latency).

The sub-second latency mode supports RTMP and ARTC for ingest and HLS, FLV, RTMP, and ARTC for playback. Live streams that contain B-frames and AAC are not supported.

Create interactive messaging application

This project uses interactive messaging to control the live stream. Use cases include notifying viewers when the stream starts and ends, displaying announcements and viewer likes, muting viewers, and showing on-screen comments between the host and viewers. For co-streaming rooms, this also includes notifying the host of viewer requests to join the video stream. To enable these features, you must create an interactive messaging application.

1. In the left-side navigation pane of the ApsaraVideo Live console, choose Features > Interactive Messaging > Application Management.

2. Click Create Application.

3. In the Create Application dialog box, select a region and enter an application name. For now, you can leave callback settings and security moderation disabled.

4. Click Create. The new application is added to the list, and the system automatically generates an App ID, AppKey, AppSign, and creation time.

View the details and save the App ID, AppKey, and AppSign for your server-side deployment.

Create RTC application

This project supports both basic live rooms and co-streaming rooms. Co-streaming rooms allow viewers to request to join the stream by video. Because co-streaming rooms require audio and video co-streaming and stream mixing, you must create a Real-Time Communication (RTC) application. This feature enables viewers to co-stream with the host. The following figure shows the co-streaming model. When a viewer co-streams with the host, other viewers receive a mixed stream of all on-stage participants.

You must create an RTC application in the console. For a complete walkthrough of setting up a co-streaming scenario, see Quick start for co-streaming.

1. In the left-side navigation pane of the ApsaraVideo Live console, choose Features > Real-Time Communication > Application Management.

2. On the Application Management page, click Create Application, enter a custom instance name, select the Terms of Service checkbox, and then click Buy Now.

   Note

   Creating an application is free of charge. You are charged on a pay-as-you-go basis for your actual usage. For more information, see Billing of audio and video calls.

3. After the application is created, refresh the Application Management page to view it.

4. Click the RTC application. On the Server-side Transcoding and Streaming page, in the Global Server-side Transcoding and Streaming to ApsaraVideo Live section, enable server-side transcoding and streaming. For the streaming domain, enter the streaming domain that you added in the Add an ingest domain section (this domain cannot be a subdomain). Enable Single-stream Pushing. If you need to configure recording or snapshots, you must do so under this domain.

In the application list on the Application Management page, the new RTC application shows a Status of Enabled and a Billing Method of By Duration.

From the application's management page, find and save the App ID and AppKey for your server-side deployment.

Record to VOD (recommended)

The following steps describe how to configure standard live recording:

1. Log on to the ApsaraVideo Live console.

2. In the left-side navigation pane, click Features > Live Recording.

3. On the Live Recording page, select the streaming domain that you want to configure.

4. On the Store in VOD tab, click Add.

5. In the dialog box, select the appropriate transcoding template and click OK.

   Note

   We recommend that you configure the transcoding template to transcode audio to AAC to ensure compatibility.

   If you have not configured a transcoding template in ApsaraVideo VOD, go to the ApsaraVideo VOD console to configure one.

   For detailed instructions, see Record and store in ApsaraVideo VOD.

Record to OSS

The following steps describe how to configure standard live recording:

1. Log on to the ApsaraVideo Live console.

2. In the left-side navigation pane, click Features > Live Recording.

3. On the Live Recording page, select the streaming domain that you want to configure.

4. On the Store in OSS tab, click Add.

5. In the dialog box, enable recording of transcoded streams, select a transcoding template ID, and then click OK. In the Recording Template (Store in OSS) dialog box, configure AppName, StreamName (enter * for all streams), storage location, splicing duration (default is 180 seconds), the recording for timed-out streams switch, and the storage format (m3u8, flv, mp4, or cmaf).

   Note

   For detailed configuration instructions, see Record and store in Object Storage Service (OSS).