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

For the demo's source code, see Try the demo.
Step 4: Apply for a license
Step 1: Create an application
Go to the My Authorizations page in the ApsaraVideo VOD console. On the Application Management tab, click Create Application.
Enter the application information. Applications are categorized by platform: Web or Mobile.
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.

Web domain guidelines
Example of a valid domain:
aliyun.com.ImportantTo cover multiple subdomains, such as
pc.aliyun.comandmobile.aliyun.com, enter only the main domainaliyun.com.Avoid the following formats:
Including a protocol prefix:
http://aliyun.comorhttps://aliyun.com.Including a path or subpage:
aliyun.com/indexoraliyun.com/login.Using a wildcard domain:
*.aliyun.comor.aliyun.com.
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
bundleNamefield of your project'sapp.json5file. After you enter the information, select the Compliance Commitment checkbox and click Create.
Bind an Android application signature
NoteThis 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.keystorecommand 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
If you have already purchased a license, proceed to Step 3: Bind a license.
Return to the My Authorizations page, select the Order Instances tab, and click Purchase License.
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.
ImportantAs shown in the figure, SDK entitlements must be purchased separately. For example, you can purchase only the player SDK Standard Edition.

After the payment is successful, return to the Order Instances tab to view your new order instance.
Step 3: Bind a license
Return to the My Authorizations page, select the License Management tab, and click Bind License.
On the Bind License page, select the application and the SDK license order to bind. After you confirm the information, click Bind.
NoteEach 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.
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
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.
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.