快速整合 - ApsaraVideo VOD

本文介紹Android播放器SDK的環境要求、整合方式及使用參考。

環境要求

類別	說明
系統版本	支援Android 4.3及以上版本。
手機晶片	架構要求： armv7。 arm64。
開發工具	推薦使用Android Studio，本文操作步驟基於Android Studio開發。下載地址：Android Studio。

前提條件

登入並擷取包含播放器授權的License檔案AliVideoCert-********.crt。具體操作，請參見擷取License。
本地整合SDK時，需要先下載Android播放器SDK包（包含了播放器SDK及Demo源碼），從V5.4.6.0版本開始Android播放器SDK提供了支援AndroidX和不支援AndroidX的Demo，請根據您的專案按需選擇下載，推薦下載使用最新版本。下載地址請參見播放器SDK。

解壓後的目錄結構如下：

表 1. SDK包目錄結構
檔案名稱	作用
demo	播放器的Demo源碼。
JavaDoc	播放器API文檔。
sdk	播放器SDK的aar庫。sdk的目錄結構參見sdk目錄結構。
X.X.XReleaseNote	版本說明。

表 2. sdk目錄結構
檔案名稱	說明
AliyunPlayer-x.x.x-full.aar	完整的aar包，包含了FFmpeg動態庫的包。
AliyunPlayer-x.x.x-part.aar	aar包，不包含FFmpeg的動態庫的包。
AlivcArtp-x.x.x.aar	支援artp協議，非必須。
AlivcArtc-x.x.x.aar	支援artc協議，非必須。

說明

如果不整合短視頻SDK，直接依賴AliyunPlayer-x.xx.x-full.aar包即可。
如果整合播放器的同時，也整合短視頻SDK，那麼播放器的SDK依賴AliyunPlayer-x.x.x-part包，同時使用共通的FFmpeg版本，即需要額外依賴com.aliyun.video.android:AlivcFFmpeg:x.x.x這個包。
如果整合時使用了錯誤的SDK包，會導致FFmpeg衝突。

使用限制

Android播放器SDK不支援模擬器，整合完成後需要真機運行。

SDK整合（本地整合）

說明

以下步驟以Android Studio Flamingo | 2022.2.1版本的Android Studio開發工具為例，其餘開發工具的操作步驟類似。

拷貝需要的aar包到工程的libs目錄下（如果沒有libs檔案夾，手動建立libs檔案夾即可）。
修改Project下的build.gradle檔案，在allprojects的repositories節點中增加flatDir的設定，樣本如下：
```
flatDir {
   dirs 'libs'
}
```

修改App的build.gradle檔案，dependencies節點中增加對aar的引用和Conan的引用，樣本如下：

dependencies {
      implementation fileTree(dir: 'libs', include: ['*.aar'])
      //阿里雲播放器5.3.0 版本以前需要引入AlivcConan庫，5.3.0及其以後的版本不需要引入。
      implementation 'com.alivc.conan:AlivcConan:x.x.x'
}

混淆配置。

在App的Proguard-rules.pro檔案中添加以下混淆配置，樣本如下：

-keep class com.alivc.**{*;}
-keep class com.aliyun.**{*;}
-keep class com.cicada.**{*;}
-dontwarn com.alivc.**
-dontwarn com.aliyun.**
-dontwarn com.cicada.**

SDK整合（Gradle整合）

說明

請確保網路正常，並且可以正常訪問阿里雲Maven倉庫。如果由於網路故障，無法從Maven倉庫下載到播放器SDK包，則建議通過本地整合方式來整合SDK，詳細請參見SDK整合（本地整合）。

在Project的build.gradle中增加阿里雲的Maven地址依賴。樣本如下：
```
maven { url "https://maven.aliyun.com/repository/releases" }
```
操作後的截圖如下：
修改App的build.gradle檔案，dependencies節點中增加依賴。樣本如下：
說明
請確保引入的播放器SDK版本號碼填寫正確，否則將報錯並引入失敗。播放器SDK的版本可以從Android播放器SDK發布歷史查看。
```
implementation 'com.aliyun.sdk.android:AliyunPlayer:x.x.x-full'
//阿里雲播放器5.3.0 版本以前需要引入AlivcConan庫，5.3.0及其以後的版本不需要引入
implementation 'com.alivc.conan:AlivcConan:x.x.x'
```
操作後的截圖如下：

配置License

說明

V5.4.7.1及之後版本的Android播放器SDK必須按以下操作配置License後，方可使用。
播放器SDK現免費提供，License有效期間為1年，1年後若無特殊約定我們將為您免費自動續期。
License配置完成後，查看日誌若無License相關報錯，則表示License配置成功。
配置的License檔案和LicenseKey和建立License時的應用資訊（PackageName和Signature）有嚴格的對應關係，請確保License檔案和LicenseKey和建立時的資訊保持一致，否則會出現鑒權失敗的情況。

將擷取到的認證檔案AliVideoCert-********.crt拷貝到Android Studio專案中，建議放到assets目錄下，也可以放到沙箱或者其他路徑。
在AndroidManifest.xml檔案中添加如下meta-data。
- key為com.aliyun.alivc_license.licensekey（全小寫），value為LicenseKey的值。
- key為com.aliyun.alivc_license.licensefile（全小寫），value為步驟二中認證檔案的放置路徑，請根據實際情況填寫。
```
<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" />
```

常見整合問題

播放器問題

功能使用文檔

基礎功能

進階功能