ApsaraVideo Live:Manage applications

Create an ARTC application

1. Log on to the ApsaraVideo Live console.

2. In the left-side navigation pane, choose Live + > ApsaraVideo Real-time Communication > Applications.

3. On the Applications page, click Create Application.

4. Enter a custom name in the Instance Name field, select Terms of Service, and then click Buy Now.

5. After the application is created, refresh the Applications page to view the application.

   Note

   By default, no fees are incurred when you create an application. You are charged based on your actual usage in the cloud. For more information, see Billing of ARTC.

Configure stream relay

1. Log on to the ApsaraVideo Live console.

2. In the left-side navigation pane, choose Live + > ApsaraVideo Real-time Communication > Applications. On the Applications page, find the application that you want to manage and click Manage in the Actions column.

3. Click Stream Relay. You can use one of the following methods to configure stream relay:

   1. Method 1: Specify streams to relay

      You can call API operations on the server side to configure stream relay for a specific channel in real time. This way, the streams can be relayed to ApsaraVideo Live or a third-party platform. This requires a small amount of development on the server side.

   2. Method 2: Configure global stream relay to ApsaraVideo Live

      After you enable the stream relay feature, audio and video streams are relayed to the origin server of ApsaraVideo Live. You can configure features such as transcoding, recording, and snapshot capture based on streaming domains. You can also pull live streams to watch.

      1. Turn on Stream Relay.

      2. Configure the stream relay parameters.

         Parameter	Configuration	Description
         Stream Relay	Select an option.	After you enable single-stream relay, all audio and video streams are relayed to ApsaraVideo Live by default. You can still update the layout of a mixed stream by using the SDK or server API.
         Streaming Domain	Example: play.example.com	The streaming domain that is relayed for standard streaming. You can play live streams, configure transcoding and recording settings, and perform other operations based on the streaming domain. Note If you do not have a streaming domain, add one on the Domain Management page. Do not enable RTS 2.0 for the streaming domain. Otherwise, stream relay fails.
         AppName	The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), underscores (_), and equal signs (=). Default value: live. You can specify a custom value.	The application name in the streaming URL after stream relay. For more information, see Generate ingest and streaming URLs. Note If you need to configure templates such as transcoding, recording, and snapshot templates for the relayed stream, you must specify an application name that is the same as the application name specified in the templates. Otherwise, the templates do not take effect.
         SEI Insertion	Insert SEI at Regular Intervals: This option lets you insert supplemental enhancement information (SEI) at a specified interval from 1,000 to 5,000 ms. Insert SEI in I-frames: This option lets you insert SEI in I-frames of a video stream.	SEI: You can use SEI to insert basic user information such as the UID and mixed-stream layout parameters into streams. This way, in co-streaming scenarios, when the layout for stream mixing and relay changes, the app that viewers use to watch streams can parse the layout information from SEI in real time. This helps facilitate the adjustment of interaction styles. For more information, see SEI format.

         Note

         • If no streaming domain exists on the Domain Management page, you need to add a domain name. For more information, see Add a domain name.

         • Do not enable RTS 2.0 for the streaming domain. Otherwise, relayed stream pulling fails.

SEI format

{"stream":[{"uid":"111","paneid":0,"zorder":1,"x":0,"y":0.25,"w":0.5,"h":0.5,"type":0,"ms":0,"vol":1,"vad":119},{"uid":"222","paneid":1,"zorder":1,"x":0.5018382,"y":0.25,"w":0.5,"h":0.5,"type":0,"ms":0,"vol":60,"vad":123}]}

Callbacks

The ARTC feature provides channel callbacks, user callbacks, and mixed-stream relay callbacks. The following section describes how to configure these callbacks in the ApsaraVideo Live console.

Overview

After you configure the callbacks, your business server can receive channel and user status changes and mixed-stream relay events that occur in an ARTC application in real time.

• Channel callbacks: Notifications about events such as creating a channel and closing a channel are sent.

• User callbacks: Notifications about events related to users are sent. For example, when a user joins or leaves a channel, a user switches the role, or a user ingests or pulls a stream.

• Mixed-stream relay callbacks: Notifications about stream relay events are sent.

For more information about channel and user callbacks, see CreateEventSub. For more information about mixed-stream relay callbacks, see CreateRtcMPUEventSub.

Create a callback task

Edit or delete a callback task

View callback records

After you create a callback task and the task takes effect, callback records are generated if related events occur. You can view the details of a callback on the Callback Records tab.