ApsaraVideo Live provides a variety of features for you to manage live streams. You can disable stream ingest, resume a live stream, and view active ingest endpoints, activity logs, and disabled ingest endpoints and their details. This topic describes the features of stream management and how to use these features.
Disable stream ingest
- The ingest URL is leaked.
- Users use the ingest URL for malicious stream ingest.
- You must meet specific business requirements.
- The ApsaraVideo Live console: In the ApsaraVideo Live console, you can view a disabled ingest endpoint, configure a disabled ingest endpoint, and resume a live stream. You can manage live streams on the Stream Management page in the ApsaraVideo Live console. For more information, see Manage streams.
Operation Description Reference ForbidLiveStream Disables the ingest URL of a live stream.
You can call this operation to interrupt a stream ingest without adding the ingest URL to the blacklist and enable stream ingest again at a preset point in time.Note You can disable the ingest of a maximum of 10,000 live streams. If the limit is exceeded, you are unable to disable the ingest of excess live streams. You can call this operation up to 20 times per second.
ForbidLiveStream ResumeLiveStream Resumes a live stream.Note You can call this operation up to 30 times per second. ResumeLiveStream
View live streams
- The ApsaraVideo Live console
ApsaraVideo Live classifies live streams into the following types: active ingest endpoints, activity logs, and disabled ingest endpoints. You can view live streams on the Ingest Endpoints page under in the ApsaraVideo Live console.
You can view the application name, stream name, start time and end time of stream ingest, ingest mode, transcoding template, stream monitoring, and streaming URL of a live stream.
Operation Description Reference DescribeLiveStreamsOnlineList Queries the information about all live streams that are being ingested for a specified domain name or for a specified application under the specified domain name. DescribeLiveStreamsOnlineList DescribeLiveStreamsPublishList Queries the stream ingest records of a specified domain name within a specified duration or a specified application or stream under the domain name within a specified duration. DescribeLiveStreamsPublishList DescribeLiveStreamsBlockList Queries the blacklist of ingest URLs for a specified domain name. DescribeLiveStreamsBlockList DescribeLiveStreamsControlHistory Queries the operation records of live streams for a specified domain name or application. DescribeLiveStreamsControlHistory DescribeLiveDomainOnlineUserNum Queries the number of online users at a specified point in time for all live streams in a streaming domain. DescribeLiveDomainOnlineUserNum
Monitor the status of live streaming
During live streaming, the playback stuttering affects user experience most.
Stuttering may occur during the playback of a live stream due to many causes, one of which is the upstream condition. Poor upstream may cause the playback stuttering on the audience side. This has a great impact on the viewing experience. ApsaraVideo Live allows you to monitor the upstream traffic. You can check the upstream status of a live stream at the earliest opportunity.
- The ApsaraVideo Live console
ApsaraVideo Live allows you to view the basic information, video and audio frame rates at different points in time, and bitrates at different points in time of a live stream. 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.
Operation Description Reference DescribeLiveDomainFrameRateAndBitRateData Queries the frame rates and bitrates of all live streams in an ingest domain. DescribeLiveDomainFrameRateAndBitRateData DescribeLiveStreamBitRateData Queries the frame rate and bitrate of an RTMP-based live stream within a specified duration. You can call this operation to query historical data. DescribeLiveStreamBitRateData