CDN acceleration

Overview

ApsaraVideo VOD supports audio and video playback. You can preview files in the console and play them through ApsaraVideo Player SDK or third-party players.

Supported file types:

• Transcoded stream files: Generated when you specify a transcoding template during upload.

• Original files: Played in original quality when you use the No Transcoding template. Supported formats: MP4, FLV, M3U8, MP3, and WEBM.

Playback modes

• Play videos based on their playback URLs

After obtaining a playback URL, play the file through ApsaraVideo Player or third-party players (system, open source, or custom).

• Use playback credentials to play videos

For higher security requirements, use ApsaraVideo Player SDK with playback credentials. Each credential grants access to a specific video for a limited time — expired or invalid credentials are rejected.

Obtain a playback URL

Obtain playback URLs through event notifications or the API/SDK.

• Event notifications

Obtain the playback URL from the StreamTranscodeComplete or TranscodeComplete callback, then save it on your server for playback.

Callback URLs are static. If URL signing is enabled, generate a signed URL — only the signed URL works for playback.

If a domain name is disabled or deleted, update the playback URL with the new domain name to avoid playback failure.

If video encryption is enabled, decrypt the playback URL before playback.

• API/SDK

Call the GetPlayInfo operation directly or through the ApsaraVideo VOD SDK. Specify the video ID obtained during upload. Demo:

package com.aliyun.sample;

import com.aliyun.tea.*;

public class Sample {

    /**
     * <b>description</b> :
     * <p>Use your AccessKey pair to initialize the client.</p>
     * @return Client
     * 
     * @throws Exception
     */
    public static com.aliyun.vod20170321.Client createClient() throws Exception {
        // A leaked AccessKey pair can expose your account and all resources within the account to serious risks. The following sample code is provided for reference only.
        com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
                // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is configured in the code runtime environment.
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is configured in the code runtime environment.
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        // For more information about endpoints, see https://api.aliyun.com/product/vod
        config.endpoint = "vod.cn-shanghai.aliyuncs.com";
        return new com.aliyun.vod20170321.Client(config);
    }

    public static void main(String[] args_) throws Exception {
        java.util.List<String> args = java.util.Arrays.asList(args_);
        com.aliyun.vod20170321.Client client = Sample.createClient();
        com.aliyun.vod20170321.models.GetPlayInfoRequest getPlayInfoRequest = new com.aliyun.vod20170321.models.GetPlayInfoRequest();
        com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
        try {
            // Write your code to print the response of the API operation if necessary.
            client.getPlayInfoWithOptions(getPlayInfoRequest, runtime);
        } catch (TeaException error) {
            // Handle exceptions with caution in actual business scenarios and do not ignore exceptions in your project. In this example, error messages are displayed for your reference only.
            // Display error messages.
            System.out.println(error.getMessage());
            // The URL that is used for troubleshooting.
            System.out.println(error.getData().get("Recommend"));
            com.aliyun.teautil.Common.assertAsString(error.message);
        } catch (Exception _error) {
            TeaException error = new TeaException(_error.getMessage(), _error);
            // Handle exceptions with caution in actual business scenarios and do not ignore exceptions in your project. In this example, error messages are displayed for your reference only.
            // Display error messages.
            System.out.println(error.getMessage());
            // The URL that is used for troubleshooting.
            System.out.println(error.getData().get("Recommend"));
            com.aliyun.teautil.Common.assertAsString(error.message);
        }        
    }
}

Obtain a playback credential

Call the GetVideoPlayAuth operation to obtain the playback credential. ApsaraVideo Player SDK then automatically retrieves the playback URL. Demo:

package com.aliyun.sample;

import com.aliyun.tea.*;

public class Sample {

    /**
     * <b>description</b> :
     * <p>Use your AccessKey pair to initialize the client.</p>
     * @return Client
     * 
     * @throws Exception
     */
    public static com.aliyun.vod20170321.Client createClient() throws Exception {
        // A leaked AccessKey pair can expose your account and all resources within the account to serious risks. The following sample code is provided for reference only.
        com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
                // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is configured in the code runtime environment.
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is configured in the code runtime environment.
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        // For more information about endpoints, see https://api.aliyun.com/product/vod
        config.endpoint = "vod.cn-shanghai.aliyuncs.com";
        return new com.aliyun.vod20170321.Client(config);
    }

    public static void main(String[] args_) throws Exception {
        java.util.List<String> args = java.util.Arrays.asList(args_);
        com.aliyun.vod20170321.Client client = Sample.createClient();
        com.aliyun.vod20170321.models.GetVideoPlayAuthRequest getVideoPlayAuthRequest = new com.aliyun.vod20170321.models.GetVideoPlayAuthRequest();
        com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
        try {
            // Write your code to print the response of the API operation if necessary.
            client.getVideoPlayAuthWithOptions(getVideoPlayAuthRequest, runtime);
        } catch (TeaException error) {
            // Handle exceptions with caution in actual business scenarios and do not ignore exceptions in your project. In this example, error messages are displayed for your reference only.
            // Display error messages.
            System.out.println(error.getMessage());
            // The URL that is used for troubleshooting.
            System.out.println(error.getData().get("Recommend"));
            com.aliyun.teautil.Common.assertAsString(error.message);
        } catch (Exception _error) {
            TeaException error = new TeaException(_error.getMessage(), _error);
            // Handle exceptions with caution in actual business scenarios and do not ignore exceptions in your project. In this example, error messages are displayed for your reference only.
            // Display error messages.
            System.out.println(error.getMessage());
            // The URL that is used for troubleshooting.
            System.out.println(error.getData().get("Recommend"));
            com.aliyun.teautil.Common.assertAsString(error.message);
        }        
    }
}