ApsaraVideo VOD:Integrate the short video SDK for Android

Prerequisites

The development environment is set up. The following table describes the requirements for the development environment.

(Recommended) Integrate the SDK by using Maven dependencies

Manually integrate the SDK

Step 1: Import AAR packages

1. Create a module.

   In Android Studio, choose File > New > New Module to create a library module. In this example, the library module named AliyunSvideoLibrary is used.

   

2. Copy AliyunSdk-RCE.aar, AlivcConan-x.x.x.aar, and AlivcCore.jar from the SDK directory to the created module and add the module to your project.

   

3. Add AAR and JAR packages by using Gradle.

   dependencies {
    implementation fileTree(include: ['*.jar','*.aar'], dir: 'libs')
   }

4. Add the dependency of the AliyunSvideoLibrary module to the app module.

    dependencies {
       implementation project(":AliyunSvideoLibrary")
   }

Step 2: Import .so files

1. Copy the jniLibs folder from the decompressed SDK package to the main folder of the app module. Then, declare the path of jniLibs in the build.gradle file of the app module.

   The following sample code provides an example:

   android {
    sourceSets.main {
        jni.srcDirs = []
        jniLibs.srcDir "src/main/jniLibs" 
    }
   }

2. Load the dynamic-link libraries that are required by the SDK.

   The dynamic-link libraries are loaded in the latest version of the SDK. You do not need to load the dynamic-link libraries.

   The following section describes the library files:

   libalivcffmpeg.so-------------Required third-party library for the SDK.
   libaliresample.so-------------------The library that is required for audio resampling. This library is optional.

3. Add the dependencies that are required to upload short videos.

   The upload SDK and OSS are required to upload short videos. If your application does not require this feature, skip this step.

   implementation 'com.aliyun.video.android:upload:1.6.4'
   implementation 'com.google.code.gson:gson:2.8.0'
   implementation 'com.squareup.okhttp3:okhttp:3.2.0'
   implementation 'com.aliyun.dpa:oss-android-sdk:+'

4. Initialize the configurations.

   Call the onCreate method of the Application class in the app module. The following sample code provides an example:

   com.aliyun.vod.common.httpfinal.QupaiHttpFinal.getInstance().initOkHttpFinal();

Add permissions

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.FLASHLIGHT" />
<uses-permission android:name="android.permission.RECORD_VIDEO" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Configure the license

After you obtain the license, perform the following steps to configure the license file. For more information about how to obtain licenses, see Obtain and use a license of the short video SDK.

Add com.aliyun.alivc_license.licensekey and com.aliyun.alivc_license.licensefile to the AndroidManifest.xml file. The value of com.aliyun.alivc_license.licensekey is the value of LicenseKey, and the value of com.aliyun.alivc_license.licensefile is the path in which the license file is stored. Sample code:

<application
   android:icon="@drawable/icon"
   android:label="@string/app_name" >
    <meta-data
         android:name="com.aliyun.alivc_license.licensekey"
         android:value="yourLicenseKey"/> // Enter the value of LicenseKey.
    <meta-data
       android:name="com.aliyun.alivc_license.licensefile"
       android:value="yourLicenseFile"/> // Enter the path in which the license file is stored. Example: assets/alivc_license/AliVideoCert.crt.
  ...
</application>

Configure obfuscation rules

You can configure the obfuscation rules in the proguard-rules.pro file. Sample code:

######################Obfuscation configuration of the short video SDK#########################
-keep class com.aliyun.**{*;}
-keep class com.duanqu.**{*;}
-keep class com.qu.**{*;}
-keep class com.alibaba.**{*;}
-keep class component.alivc.**{*;}
-keep class com.alivc.**{*;}
-keep class org.webrtc.**{*;}
-keep class org.ugsv.**{*;}

What to do next

Initialize the short video SDK for Android

References

• API references

• FAQ