ApsaraVideo Live:Content security

Limits

Only some live centers support the content moderation feature. For more information, see Supported regions.

Automated review

• Background information

  Live streams that are ingested by streamers may contain undesirable content. ApsaraVideo Live provides the automated review feature to automatically and intelligently review video and audio streams. The feature significantly reduces content violations such as pornography, violence, terrorism, and politics and reduces the cost of manual review.

• Overview

  Based on large amounts of tagged data and deep learning algorithms, the automated review feature accurately detects undesirable content in live streams from multiple dimensions such as voice and vision. The automated review feature provides multiple functional modules, including pornography detection, terrorism detection, ad violation detection, meaningless content detection, and audio moderation.

  • Video moderation: reviews captured frames to check whether live streams contain undesirable content, and returns the review results in callbacks if such content is detected. Then, you can process the live streams that contain undesirable content.

  • Audio moderation: recognizes the audio in live streams to check whether the audio contains undesirable content, and returns the review results in callbacks if such content is detected. Then, you can process the live streams that contain undesirable content.

  The following table describes the capabilities of the automated review feature.

  Capability	Scene	Description	Category of the moderation results
  Pornography detection	porn	Detects pornographic content in live streams.	normal, sexy, and porn
  Terrorism detection	terrorism	Detects terrorism content in live streams.	normal, bloody, explosion, outfit, logo, weapon, politics, violence, crowd, parade, carcrash, flag, location, and others
  Ad violation detection	ad	Detects ad violations in live streams.	normal, ad, npx, qrcode, and programCode
  Undesirable scene detection	live	Detects undesirable scenes in live streams, such as black screen, black edge, dark image, picture-in-picture (PIP), smoking, and fighting.	normal, meaningless, PIP, smoking, and drivelive
  Logo detection	logo	Detects controlled logos and trademarks in live streams.	normal, TV, and trademark
  Audio moderation	antispam	Detects undesirable content in audio, such as spam, ad, politics, violence, abuse, pornographic content, junk content, prohibited content, and meaningless content.	normal, spam, ad, politics, terrorism, abuse, porn, flood, contraband, meaningless, and customized

• Usage

  • Prerequisites

    1. ApsaraVideo Live is activated and a valid domain name for ApsaraVideo Live is configured.

    2. An HTTP service is configured to receive the callbacks about undesirable content that is detected in video or audio streams.

  • Procedure

    1. Add automated review configurations.

    2. Configure a callback URL.

    3. Ingest a stream. The stream is automatically reviewed.

       Note

       Automated review takes effect only for streams that are ingested after the automated review configurations are added.

  • Use the ApsaraVideo Live console

    Video moderation: You can configure video moderation templates and a callback URL. For more information, see Configure content moderation.

    Audio moderation: You cannot configure audio moderation in the ApsaraVideo Live console.

  • Call an API operation

    Video moderation

    Operation	Description	References
    AddLiveSnapshotDetectPornConfig	Adds a video moderation configuration.	AddLiveSnapshotDetectPornConfig
    DeleteLiveSnapshotDetectPornConfig	Deletes a video moderation configuration.	DeleteLiveSnapshotDetectPornConfig
    UpdateLiveSnapshotDetectPornConfig	Modifies a video moderation configuration.	UpdateLiveSnapshotDetectPornConfig
    DescribeLiveSnapshotDetectPornConfig	Queries video moderation configurations.	DescribeLiveSnapshotDetectPornConfig
    AddLiveDetectNotifyConfig	Configures callbacks for video moderation results. For more information about the default format of the callbacks, see Default format of video moderation callbacks.	AddLiveDetectNotifyConfig
    DeleteLiveDetectNotifyConfig	Deletes the configuration of callbacks for video moderation results.	DeleteLiveDetectNotifyConfig
    UpdateLiveDetectNotifyConfig	Modifies the configuration of callbacks for video moderation results.	UpdateLiveDetectNotifyConfig
    DescribeLiveAudioAuditNotifyConfig	Queries the configuration of callbacks for video moderation results.	DescribeLiveDetectNotifyConfig

    Audio moderation

    Operation	Description	References
    AddLiveAudioAuditConfig	Add an audio moderation configuration.	AddLiveAudioAuditConfig
    DeleteLiveAudioAuditConfig	Deletes an audio moderation configuration.	DeleteLiveAudioAuditConfig
    UpdateLiveAudioAuditConfig	Modifies an audio moderation configuration.	UpdateLiveAudioAuditConfig
    DescribeLiveSnapshotDetectPornConfig	Queries audio moderation configurations.	DescribeLiveAudioAuditConfig
    AddLiveAudioAuditNotifyConfig	Configures callbacks for audio moderation results. You can customize the callbacks in the JSON format based on your business requirements. For more information about the default format of the callbacks, see Default format of audio moderation callbacks.	AddLiveAudioAuditNotifyConfig
    DeleteLiveAudioAuditNotifyConfig	Deletes the configuration of callbacks for audio moderation results.	DeleteLiveAudioAuditNotifyConfig
    UpdateLiveAudioAuditNotifyConfig	Modifies the configuration of callbacks for audio moderation results.	UpdateLiveAudioAuditNotifyConfig
    DescribeLiveAudioAuditNotifyConfig	Queries the configuration of callbacks for audio moderation results.	DescribeLiveAudioAuditNotifyConfig

• Billing rules: The automated review feature performs video moderation and audio moderation. Video moderation is billed based on the number of video images that are scanned. Audio moderation is billed based on the total length of audio that is reviewed. For more information, see Billing of automated review.

Disable a live stream

Usage notes

• Use the ApsaraVideo Live console: You can disable a stream, view a disabled stream, and enable a disabled stream. For more information about how to disable a stream, see Manage active streams. For more information about how to view or enable a disabled stream, see Manage disabled streams.

• Use the ApsaraVideo Live API

  API operation	Description	References
  ForbidLiveStream	Disables a live stream. You can call this operation to interrupt a stream without adding the ingest URL to the blacklist and resume the stream at a preset 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 per account.	ForbidLiveStream
  ResumeLiveStream	Resumes a live stream. Note You can call this operation up to 30 times per second per account.	ResumeLiveStream

  The following sample code provides an example on how to use the server SDK for Java to disable a live stream:

          // Replace the parameters in <> with actual values.
          DefaultProfile profile = DefaultProfile.getProfile("<regionId>", "<ALIBABA_CLOUD_ACCESS_KEY_ID>", "<ALIBABA_CLOUD_ACCESS_KEY_SECRET>");
          IAcsClient client = new DefaultAcsClient(profile);
          ForbidLiveStreamRequest forbidLiveStreamRequest=new ForbidLiveStreamRequest();
          forbidLiveStreamRequest.setDomainName("<DomainName>");
          forbidLiveStreamRequest.setAppName("<AppName>");
          forbidLiveStreamRequest.setStreamName("<StreamName>");
          forbidLiveStreamRequest.setLiveStreamType("publisher");
          try {
              ForbidLiveStreamResponse forbidLiveStreamResponse = client.getAcsResponse(forbidLiveStreamRequest);
              System.out.println(new Gson().toJson(forbidLiveStreamResponse));
              // todo something.
          } catch (ServerException e) {
              // TODO Auto-generated catch block
              e.printStackTrace();
          } catch (ClientException e) {
              // TODO Auto-generated catch block
              e.printStackTrace();
          }

  Note

  • In the preceding example, the stream <StreamName> in the application <AppName> under the domain name <DomainName> is disabled for a default period of 6 months. The LiveStreamType parameter is set to publisher, which indicates that the stream is ingested by a streamer.

  • Currently, the LiveStreamType parameter supports only the value publisher.

  • For more information about the server SDK for Java, see Use the server SDK for Java.

Default format of video moderation callbacks

ApsaraVideo Live sends a callback message only when illegal video content is detected. The callback message contains the review information and storage information of the illegal video content.

{
 "DomainName": "example.com",
 "AppName": "liveApp****",
 "StreamName": "liveStream****",
 "OssEndpoint": "oss-cn-hangzhou.aliyuncs.com",
 "OssBucket": "liveBucket****",
 "OssObject": "liveObject****.jpg",
 "Result": [
     {
         "BizType": "example.com",
         "Result": [
             {"Label": "Porn", "Rate":11, "Suggestion": "review", "Scene":"porn", "Extent": {}},
             {"Label": "Ad", "Rate":11, "Suggestion": "review", "Scene":"ad", "Extent": {}}
         ]
     }
 ]
}
                    

Default format of audio moderation callbacks

ApsaraVideo Live sends a callback message only when illegal audio content is detected. The callback message contains the detected text of the illegal audio content and the context in the last minute.

{
    "domain": "example.com",
    "app": "liveApp****",
    "stream": "5d9747eba39b44769852d276f9ff****",
    "timestamp": 1572248095,
    "result": [
        {
            "scene": "antispam",
            "label": "ad",
            "suggestion": "block",
            "rate": 99.91,
            "details": [
                {
                    "startTime": 1572248023,
                    "endTime": 1572248040,
                    "text": "You can share the privilege of 120-day free stay in hotels in Dali and Longchuan with your friends and relatives. Welcome to Yunqi International Hotel. The hotel is located next to Dengchao KTV, No. 96, Tuanjie Street, Mang City. The hotel phone number is 2285699.",
                    "label": "ad"
                },
                {
                    "startTime": 1572248040,
                    "endTime": 1572248070,
                    "text": "Classic villas near warm springs such as Lianghe Jinta Spring and Spring Tourist Town in Binjiangyuan are available for sale on November 2. We offer various layouts, classic designs, and attractive prices. Buy a villa and then you can enjoy spring at home. Welcome to visit the villas. The address is No. 229, Xianfeng Road, Zhedao Town, Ranhe County. Call our hotline at 069269557776955777.",
                    "label": "normal"
                },
                {
                    "startTime": 1572248072,
                    "endTime": 1572248077,
                    "text": "Happy time with you is great.",
                    "label": "normal"
                },
                {
                    "startTime": 1572248078,
                    "endTime": 1572248086,
                    "text": "fme043 Snatch a little leisure from a busy life. With songs, I feel relaxed. With films, I miss you.",
                    "label": "normal"
                }
            ]
        }
    ]
}