クイック統合

環境要件

前提条件

• ApsaraVideo Player SDKのライセンスが登録され、ライセンスファイルAliVideoCert-********.crtが取得されます。 詳細については、「ライセンスの管理」をご参照ください。

• Android用ApsaraVideo Player SDKのパッケージとデモのソースコードがダウンロードされます。 ApsaraVideo Player SDK for Android V5.4.6.0以降のバージョンでは、AndroidXをサポートしないデモとAndroidXをサポートするデモが提供されます。 ビジネス要件に基づいて、SDKパッケージと最新バージョンのデモをダウンロードすることを推奨します。 ダウンロードリンクの詳細については、「SDKの概要とダウンロード」をご参照ください。

制限

ApsaraVideo Player SDK for Androidはシミュレーターでは実行できません。 ApsaraVideo Player SDK for Androidを統合したら、AndroidデバイスでSDKを実行する必要があります。

ローカルファイルを追加して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を統合する

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

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

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

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'

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

Androidアプリケーションにライセンスをバインドする

1. ライセンスを設定します。

   1. (推奨) ライセンスファイルをAndroid Studioプロジェクトのアセットディレクトリにコピーします。

      説明

      ライセンスファイルをデバイス上の別のディレクトリにコピーすることもできます。 その場合は、グローバル環境の場合はcom.aliyun.alivc_license.licensefile、国際環境の場合はcom.aliyun.alivc_license.licensefile_SEAに対応する値が、ライセンスファイルのパスと同じであることを確認してください。

   2. AndroidManifest.xmlファイルに <meta-data> 要素を追加します。

      重要

      • ライセンスの設定後に認証が失敗した場合は、<application> 要素の下に <meta-data> 要素が追加されているかどうか、および <meta-data> 要素の名前が正しいかどうかを確認します。 問題が解決しない場合は、[ライセンスに関するFAQ] を参照して問題のトラブルシューティングを行います。

      • Alibaba Cloudの国際サイト (alibabacloud.com) でApsaraVideo Player SDK V6.14.0以降を使用する場合は、国際環境のライセンスを設定する必要があります。 ApsaraVideo Player SDKを使用しない場合は、グローバル環境のライセンスを設定できます。

      • グローバル環境用と国際環境用の2つのライセンスを同時にアプリケーションにバインドできます。 次に、アプリケーションを起動するたびにApsaraVideo player SDKのサービス環境を設定することで、プレーヤーを使用する環境を指定できます。 プレイヤーの実行中は環境を切り替えることはできません。

      

      // Configure a license for the global environment. This is the default configuration.
      <meta-data
          android:name="com.aliyun.alivc_license.licensekey"
          android:value="foIVziMaUHaRqgDyhf6b6eb8fcf014af39535d0720a32****"/>  <!-- TODO: Specify the license key.-->
      <meta-data
          android:name="com.aliyun.alivc_license.licensefile"
          android:value="assets/cert/release.crt"/>  <!-- TODO: Specify the path of your license file.-->
      
      
      // Configure a license for the international environment and add _SEA to the end of the license name.
      <meta-data
          android:name="com.aliyun.alivc_license.licensekey_SEA"
          android:value="f6b6foIVziMaUHaRqgDyheb8fcf014af39535d0a32720****"/>  <!-- TODO: Specify the license key.-->
      <meta-data
          android:name="com.aliyun.alivc_license.licensefile_SEA"
          android:value="assets/cert/release.crt"/>  <!-- TODO: Specify the path of your license file.-->

2. ApsaraVideo Player SDKのサービス環境を設定します。 この手順は、Alibaba Cloud国際サイト (alibabacloud.com) を使用する場合に必要です。

   ApsaraVideo Player SDK V6.14.0以降では、サービス環境を選択できます。 デフォルトでは、グローバル環境はApsaraVideo Player SDK V6.14.0以降に設定されています。 Alibaba Cloud国際サイト (alibabacloud.com) のユーザーは、グローバル環境を使用できません。 Alibaba Cloud国際サイト (alibabacloud.com) を使用する場合は、アプリケーションを起動するたびに、次の方法を使用して、サービス環境をApsaraVideo Player SDKの国際環境に更新する必要があります。 それ以外の場合、アプリケーションがApsaraVideo Player SDKを使用することを許可するライセンスの認証は失敗します。 V6.14.0より前のバージョンのApsaraVideo Player SDKを使用する、または他のSDKを使用するなどのシナリオでは、この手順は無視できます。

   // When you use the Alibaba Cloud international site (alibabacloud.com), make sure that you have updated the service environment before calling an API operation of the player. This ensures that all subsequent services will run on the Alibaba Cloud international site (alibabacloud.com).
   // Update the service environment to the international environment by calling the following operation. You cannot alter the environment when the player is running.
   AlivcBase.getEnvironmentManager().setGlobalEnvironment(AlivcEnv.GlobalEnv.ENV_SEA);

よくある質問

FAQについてのプレーヤー

関連ドキュメント

基本機能

高度な機能