このトピックでは、ApsaraVideo Player SDK for Androidの環境要件、統合方法、および使用方法について説明します。
環境要件
項目 | 説明 |
Android 版 | Android 4.3以降 |
携帯電話プロセッサ | 次のいずれかのプロセッサアーキテクチャを使用する必要があります。
|
开発ツール | Android Studioの使用を推奨します。 このトピックの手順は、Android Studioに基づいています。 Android Studioをダウンロードするには、Android Studioにアクセスしてください。 |
前提条件
ApsaraVideo Player SDKのライセンスが登録され、ライセンスファイル
AliVideoCert-********.crt
が取得されます。 詳細については、「ライセンスの取得」をご参照ください。Android用ApsaraVideo Player SDKのパッケージとデモのソースコードがダウンロードされます。 ApsaraVideo Player SDK for Android V5.4.6.0以降のバージョンでは、AndroidXをサポートしないデモとAndroidXをサポートするデモが提供されます。 ビジネス要件に基づいて、SDKパッケージと最新バージョンのデモをダウンロードすることを推奨します。 ダウンロードリンクの詳細については、「SDKの概要とダウンロード」をご参照ください。
次の表に、パッケージが解凍された後のSDKパッケージ内のフォルダーまたはファイルを示します。
表 1. SDKパッケージ内のフォルダまたはファイル
フォルダまたはファイル | 説明 |
demo | ApsaraVideo Playerのデモのソースコード。 |
JavaDoc | ApsaraVideo PlayerのAPIリファレンス。 |
sdk | ApsaraVideo Player SDK for AndroidのAndroidアーカイブ (AAR) ライブラリ。 sdkフォルダの詳細については、「sdkフォルダ内のファイル」をご参照ください。 |
X.X.XReleaseNote | ApsaraVideo Player SDK for Androidのリリースノート。 |
表 2. sdkフォルダ内のファイル
ファイル | 説明 |
AliyunPlayer-x.x.x-full.aar | FFmpegを含むAARパッケージ。 |
AliyunPlayer-x.x.x-part.aar | FFmpegを含まないAARパッケージ。 |
AlivcArtp-x.x.x.aar | Alibaba Real-time Transport Protocol (ARTP) プロトコルをサポートするAARパッケージ。 このパッケージはオプションです。 |
AlivcArtc-x.x.x.aar | Alibaba Real-Time Communication (ARTC) プロトコルをサポートするAARパッケージ。 このパッケージはオプションです。 |
短いビデオSDKを統合しない場合は、AliyunPlayer-x.xx.x-full.aarの依存関係をプロジェクトに追加します。
Android用のショートビデオSDKとAndroid用のApsaraVideo Player SDKを同時に統合する場合は、ApsaraVideo Player SDKとcom.aliyun.video.android:AlivcFFmpeg:x.x.x依存関係をApsaraVideo Player SDKとショートビデオSDKの両方のAliyunPlayer-x.x.x-part.aar依存関係をプロジェクトに追加する必要があります。
ApsaraVideo Player SDK for Androidを統合するときに無効な依存関係を含めると、FFmpegの競合が発生する可能性があります。
制限
ApsaraVideo Player SDK for Androidはシミュレーターでは実行できません。 ApsaraVideo Player SDK for Androidを統合したら、AndroidデバイスでSDKを実行する必要があります。
ローカルファイルを追加してSDKを統合する
次のセクションでは、Android Studio Flamingo | 2022.2.1を使用してApsaraVideo Player SDK for Androidを統合する方法について説明します。 手順に従って、他の開発ツールを使用してSDKを統合することもできます。
必要なAARパッケージをプロジェクトのlibsフォルダーにコピーします。 libsフォルダが存在しない場合は、libsフォルダを作成します。
プロジェクトのbuild.gradleファイルで、allprojectsブロックのrepositoriesセクションにflatDir設定を追加します。 サンプルコード:
flatDir { dirs 'libs' }
AARパッケージとConanパッケージへの参照を、アプリケーションのbuild.gradleファイルの依存関係ブロックに追加します。 サンプルコード:
dependencies { implementation fileTree(dir: 'libs', include: ['*.aar']) // You need to add the reference to the Conan package to the dependencies block only for ApsaraVideo Player V5.3.0 and earlier versions. implementation 'com.alivc.conan:AlivcConan:x.x.x' }
難読化ルールを設定します。
アプリケーションのProguard-rules.proファイルに難読化ルールを追加します。 サンプルコード:
-keep class com.alivc.**{*;} -keep class com.aliyun.**{*;} -keep class com.cicada.**{*;} -dontwarn com.alivc.** -dontwarn com.aliyun.** -dontwarn com.cicada.**
Gradleを使用してSDKを統合する
ネットワークにアクセス可能で、Alibaba Cloud Mavenリポジトリにアクセスできることを確認します。 ネットワークエラーのためにApsaraVideo Player SDK for AndroidパッケージをMavenリポジトリからダウンロードできない場合は、ローカルファイルを追加してSDKを統合することを推奨します。 詳細については、「ローカルファイルの追加によるSDKの統合」をご参照ください。
Alibaba Cloud MavenリポジトリのURLをプロジェクトのbuild.gradleファイルに追加します。 サンプルコード:
maven { url "https://maven.aliyun.com/repository/releases" }
次の図は、上記の操作の結果を示しています。
アプリケーションのbuild.gradleファイルのdependenciesブロックに依存関係を追加します。 サンプルコード:
説明SDKのバージョン番号が正しいことを確認してください。 それ以外の場合、エラーが報告され、依存関係の追加に失敗します。 ApsaraVideo Player SDK For Androidのバージョンの詳細については、「ApsaraVideo Player SDK for Androidのリリースノート」をご参照ください。
implementation 'com.aliyun.sdk.android:AliyunPlayer:x.x.x-full' // You need to add the reference to Conan package to the dependencies block only for ApsaraVideo Player V5.3.0 and earlier versions. implementation 'com.alivc.conan:AlivcConan:x.x.x'
次の図は、上記の操作の結果を示しています。
ライセンスの設定
ApsaraVideo Player SDK for Android V5.4.7.1以降のバージョンのライセンスを設定するには、SDKを使用する前に、次の操作を実行する必要があります。
ApsaraVideo Player SDK for Androidは無料で使用できます。 SDKライセンスの有効期間は1年です。 デフォルトでは、ライセンスの有効期限が切れると、システムは自動的に無料でライセンスを更新します。 SDKライセンスが更新されると、システムはローカル証明書を更新します。 新しいバージョンのアプリケーションを公開するときは、最新のローカル証明書を統合することをお勧めします。 ApsaraVideo VODコンソールで最新の証明書を取得できます。 詳細については、「Manage licenses」をご参照ください。
ライセンスを設定したら、ログを確認します。 ライセンス関連のエラーが報告されない場合、ライセンスは正しく構成されています。
設定されたライセンスファイルとライセンスキーは、PackageNameとSignatureで指定されたアプリケーションで使用する必要があります。 ライセンスファイルまたはライセンスキーがアプリケーションと一致しない場合、認証は失敗します。
ライセンスファイル
AliVideoCert-********.crt
をAndroid Studioプロジェクトにコピーします。 ファイルをassetsディレクトリに保存することを推奨します。 サンドボックスディレクトリまたは他のディレクトリにファイルを配置することもできます。AndroidManifest.xmlファイルに次のメタデータを追加します。
最初のキーを
com.aliyun.alivc_license.licensekey
に設定し、値をLicenseKeyの値に設定します。 キーは小文字でなければなりません。2番目のキーを
com.aliyun.alivc_license.licensefile
に設定し、値をライセンスファイルが格納されているパスに設定します。 キーは小文字でなければなりません。
<meta-data android:name="com.aliyun.alivc_license.licensekey" android:value="xxxxxxxxx" /> <meta-data android:name="com.aliyun.alivc_license.licensefile" android:value="assets/license.crt" />