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

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

前提条件

次の表に、必要な開発環境を示します。

カテゴリ	説明
システムバージョン	Android 4.3 以降をサポートしています。
Java バージョン	Java 1.7 以降をサポートしています。
API レベル	Android SDK API レベル 18 以降をサポートしています。
Android Studio バージョン	Android Studio 2.3 以降をサポートしています。Android Studio をダウンロードしてください。

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

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

アプリプロジェクトディレクトリの build.gradle ファイルに次の依存関係を追加します。

重要

ショートビデオ SDK V3.24.0 以降を使用する場合は、FFmpeg V4.3.0 以降を使用する必要があります。

V7.0.0 以降の統合

dependencies{
    implementation 'com.aliyun.aio:AliVCSDK_ShortVideo:7.10.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 命令セットの .so ファイルのみを提供しています。armeabi 命令セットのサポートが必要な場合は、armeabi-v7a ディレクトリから armeabi ディレクトリに .so ファイルをコピーできます。注：ショートビデオ 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 に、値をご利用の LicenseKey に設定します。2 番目の要素では、キー名を 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"/> // ご利用の LicenseKey を入力します。
    <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 の初期化

プレーヤーの統合

ショートビデオ SDK と Android 用プレーヤー SDK の両方をプロジェクトに統合するには、Android 用オールインワン SDK を使用してください。これにより、コンパイルの失敗を引き起こす可能性のあるクラスの重複問題を回避できます。

ApsaraVideo VOD:SDK の統合