Android 用短動画 SDK の統合 - ApsaraVideo VOD - Alibaba Cloud ドキュメントセンター

このトピックでは、Maven を使用して Android 用短動画 SDK を統合する方法について説明します。

前提条件

開発を開始する前に、次の環境要件を満たす必要があります：

カテゴリ	注：
システムバージョン	4.3 以降。
Java バージョン	1.7 以降。
Android API レベル	Android SDK API レベル 18 以降と互換性があります。
Android Studio バージョン	2.3 以降。Android Studio のダウンロード

(推奨) Maven を使用した SDK の統合

Alibaba Cloud Maven リポジトリを追加します。
プロジェクトの build.gradle ファイルに Alibaba Cloud Maven リポジトリの URL を追加します。
```
allprojects {
    repositories {
        maven {
            url 'https://maven.aliyun.com/nexus/content/repositories/releases/'
       }
    }
}
```

app モジュールの build.gradle ファイルに次の依存関係を追加します：

重要

短編動画 SDK V3.24.0 以降を使用する場合は、AlivcFFmpeg V4.3.0 以降を使用していることを確認してください。

V7.0.0 以降

dependencies{
    implementation 'com.aliyun.aio:AliVCSDK_ShortVideo:7.9.1'// 必須。短動画 SDK の依存関係。
    implementation 'com.google.code.gson:gson:2.8.0'// サードパーティの依存関係ライブラリ。
    implementation 'com.aliyun.video.android:upload:1.6.7' // オプション。アップロードライブラリ。アップロード機能が不要な場合は、この依存関係を削除できます。
    implementation 'com.aliyun.dpa:oss-android-sdk:+'// オプション。短動画のアップロードには、アップロード SDK と OSS が必要です。アップロード機能が不要な場合は、この依存関係を削除できます。
}

V6.21.0 以前

dependencies{
  implementation 'com.aliyun.video.android:svideopro:6.21.0'// Professional Edition に必須
  implementation 'com.aliyun.video.android:svideostandard:6.21.0'// Standard Edition に必須
  implementation 'com.aliyun.video.android:svideosnap:6.1.0'// Basic Edition に必須
   // その他の依存関係。
  implementation 'com.aliyun.video.android:AlivcFFmpeg:4.3.6'
  implementation 'com.google.code.gson:gson:2.8.0'    // サードパーティの依存関係。
 }

説明

現在、短編動画 SDK は armeabi-v7a と arm64-v8a の命令セットのみをサポートしています。armeabi との互換性が必要な場合は、回避策として armeabi-v7a の .so ファイルを armeabi フォルダーにコピーすることを推奨します。Android の進化と、短編動画 SDK の最小要件が Android 4.3 であることを考慮すると、ARMv5 および ARMv6 デバイスは旧式であるため、これらのサポートは不要です。

権限の設定

<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" />

説明

Android 6.0 以降では、動的な権限リクエストが必要です。

ライセンスの設定

ライセンスを取得した後、ライセンスファイルを設定する必要があります。ライセンスの取得方法については、「SDK ライセンスの取得」をご参照ください。

AndroidManifest.xml ファイルに、2 つの <meta-data> エントリを追加します。最初のエントリには、キー com.aliyun.alivc_license.licensekey (すべて小文字) を設定し、値にはご利用のライセンスキーを設定します。2 番目のエントriには、キー com.aliyun.alivc_license.licensefile (すべて小文字) を設定し、値には埋め込みライセンスファイルのパスを設定します。サンプルコード：

<application
   android:icon="@drawable/icon"
   android:label="@string/app_name" >
    <meta-data
         android:name="com.aliyun.alivc_license.licensekey"
         android:value="yourLicenseKey"/> // ご利用のライセンスキーを入力します。
    <meta-data
       android:name="com.aliyun.alivc_license.licensefile"
       android:value="yourLicenseFile"/> // 埋め込みライセンスファイルのパスを入力します。例：assets/alivc_license/AliVideoCert.crt。
  ...
</application>

難読化ルールの設定

proguard-rules.pro ファイルで難読化ルールを設定できます。サンプルコード：

######################短編動画 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.**{*;}

次のステップ

短編動画 SDK for Android の初期化

プレーヤーの統合

プロジェクトに短動画 SDK とプレーヤー SDK の両方を統合するには、ApsaraVideo MediaBox SDK for Android を使用することを推奨します。このオールインワンソリューションにより、クラスの重複エラーやコンパイルの失敗を防ぐことができます。

ApsaraVideo VOD:SDK の統合