Android 向けショートビデオ SDK の統合 - ApsaraVideo VOD - Alibaba Cloud ドキュメントセンター

このトピックでは、Maven を使用してショートビデオ SDK for Android を統合する方法について説明します。

前提条件

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

項目	要件
Android バージョン	4.3 以降。
Java バージョン	1.7 以降。
Android 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.11.0'// ショートビデオ 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 を、ライセンスファイルのパスには 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 の統合