All Products
Search
Document Center

Apsara Video SDK:Quick start

Last Updated:Aug 20, 2026

Quickly integrate the ApsaraVideo MediaBox SDK into your app by following these steps.

Step 1: Understand MediaBox SDK features

The MediaBox Audio/Video SDK offers four all-in-one SDKs for different scenarios: Basic Live, Interactive Live, Short Video, and Standard.

Feature

Player SDK

Push SDK

ARTC SDK

Short Video SDK

Queen SDK

Start streaming

Supported

  • Streamer-viewer interactive streaming

  • Cross-channel PK battles

Supported

(Interactive Edition)

Supported

Audio/video calls

Supported

Video recording

Supported

Video editing

Supported

Video upload

Supported

Live playback

Supported

VOD playback

Supported

Retouching and effects

Supported

Gesture recognition

Supported

Smart matting

Supported

(Optional) Step 2: Try the MediaBox SDK demo

Scan the following QR code to download and install the MediaBox SDK demo app.

image.png

For the demo's source code, see Try the demo.

Step 4: Apply for a license

Step 1: Create an application

  1. Go to the My Authorizations page in the ApsaraVideo VOD console. On the Application Management tab, click Create Application.

  2. Enter the application information. Applications are categorized by platform: Web or Mobile.

    1. Web: Enter an Application Name and the corresponding Web Domain. Select I understand and agree to the compliance commitments (click View Statement for details), and then click Create.

      截屏2026-01-13 16

      Web domain guidelines

      • Example of a valid domain: aliyun.com.

        Important

        To cover multiple subdomains, such as pc.aliyun.com and mobile.aliyun.com, enter only the main domain aliyun.com.

      • Avoid the following formats:

        • Including a protocol prefix: http://aliyun.com or https://aliyun.com.

        • Including a path or subpage: aliyun.com/index or aliyun.com/login.

        • Using a wildcard domain: *.aliyun.com or .aliyun.com.

    2. Mobile: Select a platform, enter an Application Name, and provide the corresponding Android package name, iOS Bundle ID, and HarmonyOS Bundle ID to create the application.

      The HarmonyOS Bundle ID can be found in the bundleName field of your project's app.json5 file. After you enter the information, select the Compliance Commitment checkbox and click Create.

      截屏2026-01-13 16

      Bind an Android application signature

      Note
      • This field is required if you select Android for the Platform Type and check Bind Signature.

      • Binding a signature enhances security by preventing other applications with the same package name from using the license.

      • Newer SDK versions do not require a bound signature, including ApsaraVideo MediaBox v1.7.0 and later, player SDK v5.5.2 and later, live streaming SDK v4.4.9 and later, and short video SDK v3.36.0 and later.

      You can obtain the MD5 value of your Android application signature in two ways:

      • Run the keytool -v -list -keystore your.keystore command to view the MD5 value of the corresponding signature.

      • From Android Studio: Click Gradle in the right-hand sidebar and navigate to Tasks > android > signingReport for the app. Convert any letters in the resulting MD5 value to lowercase and remove the colons.

        publishNonDefault is deprecated and has no effect anymore. All variants are now published.
        AGPBI: {"kind":"warning","text":"        Using flatDirs should be avoided because it doesn't support any meta-data formats.\n                Currently detected u..."}
        AGPBI: {"kind":"warning","text":"Please remove usages of `jcenter()` Maven repository from your build scripts and migrate your build to other Maven repositories.\nThis repository is deprecated..."}
        > Task :lista...
            Variant: debug
            Config: debug
            Store: /Us...
            Alias: and
            MD5: 5A:1E...
            SHA1: 7C:D...
            SHA-256: 5...
            Valid until: Tuesday, March 1, 2044
            ----------
            Variant: release
            Config: none
            ----------
            Variant: xxx
            Config: dxxx
            Store: /Uxxx
            Alias: androiddebugkey
            MD5: 5A:1E:F4xxx
            SHA1: 7C:D8:Exxx
            SHA-256: 55:xxx
            Valid until: Tuesday, March 1, 2044
            ----------
            Variant: debugUnitTest

Step 2: Purchase a license

Note

If you have already purchased a license, proceed to Step 3: Bind a license.

  1. Return to the My Authorizations page, select the Order Instances tab, and click Purchase License.

  2. On the ApsaraVideo MediaBox purchase page, select the SDK and function modules based on your business needs (SDK entitlements cannot be combined in a single purchase), and complete the purchase.

    Important

    As shown in the figure, SDK entitlements must be purchased separately. For example, you can purchase only the player SDK Standard Edition.image

  3. After the payment is successful, return to the Order Instances tab to view your new order instance.

Step 3: Bind a license

  1. Return to the My Authorizations page, select the License Management tab, and click Bind License.

  2. On the Bind License page, select the application and the SDK license order to bind. After you confirm the information, click Bind.

    Note

    Each license order can be bound to a single application, covering either Web or Mobile platforms.

    In the Authorized Platforms section, select the platforms that you want to authorize, such as Android. A mobile license is valid only for a mobile application.

  3. After a successful binding, return to the License Management tab to view the bound application name and its authorization information.

Step 4: Obtain authorization information

  1. On the License Management tab, find the target application. Your license key is displayed at the top of the page. Click the copy button to copy the key. A Download Certificate link is available under each application name in the list.

  2. After you confirm the authorization details, click Download Certificate to save the license file to your local machine. Also, save the license key for use during application integration. For instructions on configuring the license file, see Integrate a license.

Step 5: Integrate the SDK and configure the license

For detailed instructions, see All-in-one SDK integration.

Step 6: Implement business logic

For more information, see integration by module.