ApsaraVideo MediaBox SDK integrates audio and video functionalities including stream ingest, playback, short video production, and retouching. It also offers a unified license authorization system to grant access to these modules. This topic describes how to purchase, bind, and renew a license, and how to apply for a trial license and modify the information about the bound application.
Player SDK Professional Edition has been available for mobile clients since February 14, 2025. To obtain it, contact your account manager. To use Professional Edition on your client, bind a license to your application.
You are eligible for a one-year complimentary license for Player SDK Professional Edition if the bill of your ApsaraVideo VOD, Live, or Intelligent Media Services (IMS) reaches a certain amount. For more information, see Value-added services.
Player SDK Professional Edition only supports Player SDK V7.0.0 or later. Check the version of Player SDK used on your application before you obtain Professional Edition.
Request a license for authorization
Step 1: Create an application
Go to the My Licenses page in the ApsaraVideo VOD console, select the Application Management tab, and click Create Application.
Edit the application information. Applications are divided into web and mobile applications.
Web: Enter the Application Name and Web Domain Name.
Guidelines on web domain names:
Correct example: aliyun.com
ImportantTo cover multiple subdomains such as pc.aliyun.com and mobile.aliyun.com, enter the root domain aliyun.com.
Incorrect examples:
Including protocol headers: http://aliyun.com or https://aliyun.com
Including paths or subpages: aliyun.com/index or aliyun.com/login
Using wildcard domains: *.aliyun.com or .aliyun.com
Mobile: Enter the Application Name, Android Package Name, Bundle ID, and HarmonyOS BundleID.
Associate the signature of an Android application
NoteIf you select Android as the Platform Type and Associate Signature, the signature is required.
This operation improves application security and prevents the license from being used by another application with the same package name.
SDKs of the following versions or later do not require a signature: ApsaraVideo MediaBox SDK V1.7.0, Player SDK V5.5.2, Push SDK V4.4.9, and Short Video SDK V3.36.0.
To obtain the MD5 signature of an Android application, use one of the following methods:
Method 1: Run the
keytool -v -list -keystore your.keystore
command.Method 2: Click Gradle in the right-side navigation pane of Android Studio, find the desired application, and choose Tasks > android > signingReport. You must convert the letters into lowercase and remove semicolons (;) from the obtained MD5 signature.
Step 2: Purchase a license
If you have already purchased a license, directly bind the license to your application.
Return to the My Licenses page, select the Instance tab, and click License Purchase.
Go to the ApsaraVideo MediaBox SDK buy page. Select the SDK and corresponding functional modules based on your business requirements, and complete the purchase.
ImportantAs shown in the following figure, SDKs can only be purchased separately. For example, you must purchase Standard Edition of Player SDK individually.
Pay for the order and return to the Instance tab, where you can see the newly purchased instance.
Step 3: Bind the license
Return to the My Licenses page, select the License Management tab, and click Associate License.
On the Associate License page, select the application you want to bind and the corresponding SDK license order, and then click Associate.
NoteEach license order can only be bound to a single web or mobile application.
Return to the License Management tab. You will see the bound application name and corresponding license information.
Step 4: Obtain license information
On the License Management tab, find the desired application.
Click Download Certificate to download the certificate file to your local device. Save the license key for use when integrating the application. For how to configure the license file, see Bind a license.
Renew a license
Method 1: Renew on the License Management page
Go to the My Licenses page in the ApsaraVideo VOD console.
Select the License Management tab, find the instance ID bound to the corresponding application, and click Renew in the Actions column.
ImportantIf the instance ID is empty or an error occurs in the console during renewal, use Method 2: Purchase a new license and bind it to the application or submit a ticket.
Renewal applies to the license order. If your license order includes multiple SDKs, the renewal will apply to all of them. Configuration changes are not supported. If you have any questions, submit a ticket.
Go to the renewal management page and click Renew in the Actions column.
After confirming that your current configuration and subscription duration are correct, click Buy Now to complete the renewal. Turn on Auto-renewal to avoid expiration.
Method 2: Purchase a new license and bind it to the application
If you have purchased an SDK license but the corresponding order instance ID is empty or an error occurs in the console during renewal, place an order on the ApsaraVideo MediaBox SDK buy page before the existing license expires. Then, proceed with Step 3: Bind the license to prevent business disruptions that may occur if your application fails to call the SDK.
Apply for a trial license
You can apply for a trial license by submitting a request on Yida. The request will be processed within 1 to 2 business days.
Modify application information
You can modify the information about the application that is bound to a license in the console.
Modifying the application identifiers such as package name will cause authentication failures for applications with the original identifiers. You must download the new certificate file to replace the old one. Proceed with caution.
Log on to the ApsaraVideo VOD console.
In the left-side navigation pane, choose
.On the Application Management tab, find the desired application and click Edit in the Actions column.
Modify the application name, platform, MD5 hash, and application identifiers such as package name.
Confirm the settings and click Modify.
FAQ
How do Alibaba Finance Cloud users request a license for authorization?
Place an order on the ApsaraVideo MediaBox SDK buy page, and then submit a ticket to bind the license to your application. Alibaba Cloud does not provide notifications regarding the SDK license expiration date. Monitor the expiration date to prevent business interruptions. When submitting a ticket, include the following:
Mention that you are a Finance Cloud user.
Include the order number, a screenshot of the purchase, and your account ID.
Provide the domain name for web applications, or package name for mobile applications.
For more questions, see License FAQ.