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 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 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 instructions

  • 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.
  • API
    Operation Description Reference
    ForbidLiveStream Disables a push stream.

    You can call this operation to interrupt a push stream without adding the ingest URL to the blacklist and resume the stream at a predetermined point in time.

    Note You 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.
    ForbidLiveStream
    ResumeLiveStream Resumes a live stream.
    Note You can call this operation up to 30 times per second.
    ResumeLiveStream

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 instructions

  • The ApsaraVideo Live console

    In the ApsaraVideo Live console, click Domains in the left-side navigation pane. Find the domain that you want to manage and click Domain Settings in the Actions column. On the domain settings page, choose Stream Management > Access Control. On the page that appears, click the Protocol Prohibition tab, where you can specify whether to prohibit streaming based on the streaming protocol. For more information, see Configure protocol prohibition.

  • API
    Operation Description Reference
    BatchSetLiveDomainConfigs Configures one or more domains.

    You can set alilive in the Functions parameter to configure the protocol prohibition feature.

    BatchSetLiveDomainConfigs

Interrupt a live stream

ApsaraVideo Live allows you to interrupt a live stream.
  • After you interrupt a live stream, you only need to push 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 back-to-origin pull function 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 instructions

  • In the left-side navigation pane of the ApsaraVideo Live console, choose Stream Management > Ingest Endpoints. On the Ingest Endpoint Management page, find the stream that you want to interrupt and click Interrupt in the Actions column. For more information, see Manage streams.
  • API
    Operation Description Reference
    ForbidLiveStream Disables a push stream.

    If you set the oneshot parameter to yes, the stream is interrupted but the ingest URL is added to the blacklist.

    ForbidLiveStream

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 Stream Management in the ApsaraVideo Live console.

    ApsaraVideo Live allows you to view the following information about a live stream: application name, stream name, time at which a push stream is started and ended, pushing mode, transcoding template, stream monitoring, and streaming URL.

  • API
    Operation Description Reference
    DescribeLiveStreamsOnlineList Queries the information about all live streams that are being pushed for a specified domain name or for a specified application under the specified domain name. DescribeLiveStreamsOnlineList
    DescribeLiveStreamsPublishList Queries the stream pushing records of a specified domain name 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

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.

  • 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 Stream Management > Ingest Endpoints. Then, you can find the live stream that you want to view and click Stream Monitoring.

  • API
    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 live stream within a specified duration. You can call this operation to query historical data. DescribeLiveStreamBitRateData