すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo VOD:クイック統合

最終更新日:Oct 29, 2024

このトピックでは、ApsaraVideo Player SDK for Androidの環境要件、統合方法、および使用方法について説明します。

環境要件

項目

説明

Android 版

Android 4.3以降

携帯電話プロセッサ

次のいずれかのプロセッサアーキテクチャを使用する必要があります。

  • ARMv7

  • ARM64

开発ツール

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を統合することもできます。

  1. 必要なAARパッケージをプロジェクトのlibsフォルダーにコピーします。 libsフォルダが存在しない場合は、libsフォルダを作成します。

    图片

  2. プロジェクトのbuild.gradleファイルで、allprojectsブロックのrepositoriesセクションにflatDir設定を追加します。 サンプルコード:

    flatDir {
       dirs 'libs'
    }
  3. 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'
    }
  4. 難読化ルールを設定します。

    アプリケーションの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の統合」をご参照ください。

  1. Alibaba Cloud MavenリポジトリのURLをプロジェクトのbuild.gradleファイルに追加します。 サンプルコード:

    maven { url "https://maven.aliyun.com/repository/releases" }

    次の図は、上記の操作の結果を示しています。gradle集成

  2. アプリケーションの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で指定されたアプリケーションで使用する必要があります。 ライセンスファイルまたはライセンスキーがアプリケーションと一致しない場合、認証は失敗します。

  1. ライセンスファイルAliVideoCert-********.crtをAndroid Studioプロジェクトにコピーします。 ファイルをassetsディレクトリに保存することを推奨します。 サンドボックスディレクトリまたは他のディレクトリにファイルを配置することもできます。

  2. AndroidManifest.xmlファイルに次のメタデータを追加します。

    license1

    • 最初のキーを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" />

よくある質問

FAQについてのプレーヤー

関連ドキュメント

基本機能

高度な機能