ApsaraVideo Live provides a variety of features to help you manage live streams. You can disable, prohibit, interrupt, and resume live streams. You can also view active ingest streams, activity logs, and disabled ingest streams and their details. This topic describes the features of stream management and how to use these features.
Disable a live stream
ApsaraVideo Live provides a variety of features to help you manage live streams, including disabling a live stream. You may want to disable a live stream in the following scenarios:
An ingest URL is leaked.
An ingest URL is used for malicious purposes.
An ingest URL no longer meets business requirements.
Usage notes
Use the ApsaraVideo Live console: You can view a disabled ingest stream, configure a disabled ingest stream, and resume a live stream. You can choose in the ApsaraVideo Live console to manage live streams. For more information, see Manage streams.
Use the ApsaraVideo Live API
Operation
Description
References
ForbidLiveStream
Disables a live stream.
You can call this operation to interrupt an ingest stream without adding the ingest URL to the blacklist and resume the stream at a predetermined point in time.
NoteYou can disable up to 10,000 live streams. If the limit is exceeded, this operation fails. You can call this operation up to 20 times per second.
ResumeLiveStream
Resumes a live stream.
NoteYou can call this operation up to 30 times per second.
Prohibit a live stream
ApsaraVideo Live allows you to prohibit a live stream under a domain name based on the streaming protocol of the live stream.
Usage notes
Use the ApsaraVideo Live console
Log on to the ApsaraVideo Live console. In the left-side navigation pane, choose Acceleration > Domains. On the Domains page, find the domain that you want to manage and click Domain Settings in the Actions column. On the page that appears, choose . Then, click the Protocol Prohibition tab. You can specify whether to prohibit streaming based on the streaming protocol. For more information, see Configure protocol prohibition.
Use the ApsaraVideo Live API
Operation
Description
References
BatchSetLiveDomainConfigs
Configures one or more domains.
You can set alilive in the Functions parameter to configure the protocol prohibition feature.
Interrupt a live stream
ApsaraVideo Live allows you to interrupt a live stream.
After you interrupt a live stream, you only need to ingest the stream again to resume the live stream.
If a third-party live stream is pulled by using the method described in Configure stream pulling, you do not need to pull the stream again after the stream is interrupted. The origin fetch feature provides automatic retry, which automatically pulls the live stream.
Use case: You need to pull a stream from the origin. Sometimes, after an extended period of pulling, the audio and video may become out of sync. In this case, you need to interrupt the stream and pull the stream from the origin to sync the audio and video.
Usage notes
Log on to the ApsaraVideo Live console. In the left-side navigation pane, choose . On the Stream Management page, find the stream that you want to interrupt and click Interrupt in the Actions column. For more information, see Manage streams.
Use the ApsaraVideo Live API
Operation
Description
References
ForbidLiveStream
Interrupts a live stream.
If you set the
oneshotparameter toyes, the stream is interrupted but the ingest URL is not added to the blacklist.
View live streams
Use the ApsaraVideo Live console
ApsaraVideo Live classifies live streams into the following types: active streams, historical streams, and disabled streams. You can choose in the ApsaraVideo Live console to view live streams.
You can view the following information about a live stream: application name, stream name, time at which stream ingest is started and ended, ingest type, transcoding template, stream monitoring, and streaming URL.
Use the ApsaraVideo Live API
Operation
Description
References
DescribeLiveStreamsOnlineList
Queries the information about all active streams under a specified domain name or the active streams of an application under a specified domain name.
DescribeLiveStreamsPublishList
Queries the stream ingest records of a specified domain name or a specified application or stream under the domain name within a specified duration.
DescribeLiveStreamsBlockList
Queries the blacklist of ingest URLs for a specified domain name.
DescribeLiveStreamsControlHistory
Queries the operation records of live streams for a specified domain name or application.
DescribeLiveDomainOnlineUserNum
Queries the number of online users at a specified point in time for all live streams in a streaming domain.
Monitor the status of live streaming
Playback stuttering affects user experience the most during live streaming.
Playback stuttering occurs during live streaming for a variety of reasons such as poor uplink transmission quality. Poor uplink transmission quality causes stuttering on the audience side. This has a significant impact on the viewing experience. ApsaraVideo Live allows you to monitor uplink traffic. You can check the uplink transmission status of a live stream in real time.
Use the ApsaraVideo Live console
ApsaraVideo Live allows you to view the following information about a live stream: basic information, video and audio frame rates at different points in time, and bitrates at different points in time. You can log on to the ApsaraVideo Live console and choose . Then, you can find the live stream that you want to view and click Stream Monitoring.
Use the ApsaraVideo Live API
Operation
Description
References
DescribeLiveDomainFrameRateAndBitRateData
Queries the frame rates and bitrates of all live streams under an ingest domain.
DescribeLiveStreamBitRateData
Queries the frame rate and bitrate of an RTMP live stream within a specified duration. You can call this operation to query historical data.