1. 接入已授權播放器的音視頻終端SDK License。

   具體操作，請參見Android端接入License。

2. 將AUIShortVideoList模塊拷貝到您項目工程中。

3. 在項目gradle文件的repositories配置中，引入阿里云SDK的Maven源。

   請在項目根目錄的settings.gradle文件中添加以下內容：

   Groovy DSL示例

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

   Kotlin DSL示例

   repositories {
      // aliyun maven
      maven("https://maven.aliyun.com/repository/releases")
   }

4. 增加模塊引用方式和依賴方式。

   • 添加模塊引用，請在項目根目錄的settings.gradle文件中添加以下內容：

     Groovy DSL示例

     // 若 AUIShortVideoList 模塊位于 AUIPlayerKits 文件夾中：
     include ':AUIPlayerKits:AUIShortVideoList'
     // 若 AUIShortVideoList 模塊直接放在項目根目錄：
     include ':AUIShortVideoList'

     Kotlin DSL示例

     // 若 AUIShortVideoList 模塊位于 AUIPlayerKits 文件夾中：
     include(":AUIPlayerKits:AUIShortVideoList")
     // 若 AUIShortVideoList 模塊直接放在項目根目錄：
     include(":AUIShortVideoList")

   • 添加模塊依賴，請在app模塊的build.gradle文件中添加以下內容：

     Groovy DSL示例

     // 若 AUIShortVideoList 模塊位于 AUIPlayerKits 文件夾中：
     implementation project(':AUIPlayerKits:AUIShortVideoList')
     // 若 AUIShortVideoList 模塊直接放在項目根目錄：
     implementation project(':AUIShortVideoList')

     Kotlin DSL示例

     // 若 AUIShortVideoList 模塊位于 AUIPlayerKits 文件夾中：
     implementation(project(":AUIPlayerKits:AUIShortVideoList"))
     // 若 AUIShortVideoList 模塊直接放在項目根目錄：
     implementation(project(":AUIShortVideoList"))

5. 編譯運行，確保組件已被正確集成。

   說明

   1. 集成完成后，建議執行一次git commit，提交記錄當前組件最新的 commit ID。這為將來的組件更新提供重要的追溯依據，也記錄了組件更新前后的代碼差異，有效把控集成準入質量。同時還可以在尋求技術支持時快速定位組件版本，從而提高技術支持的效率。

   2. 集成問題詳見集成FAQ。

以下提供三種方法，通過不同方式對接AUIShortVideoList模塊，以便快速實現功能運行：

• AUIShortVideoListActivity

  您可以將短視頻列表播放Activity頁面直接提供給外部進行跳轉，具體調用邏輯可參考以下示例（videoInfoListJSON 數據獲取，參見獲取數據）。

  Java示例

  // TODO: context is android context
  Intent intent = new Intent(context, AUIShortVideoListActivity.class);
  // TODO: videoInfoListJSON is the serialized string of List<VideoInfo>
  intent.putExtra(AUIShortVideoListView.KEY_VIDEO_INFO_LIST_DATA, videoInfoListJSON);
  startActivity(intent);

  Kotlin示例

  // TODO: context is android context
  val intent = Intent(context, AUIShortVideoListActivity::class.java)
  // TODO: videoInfoListJSON is the serialized string of List<VideoInfo>
  intent.putExtra(AUIShortVideoListView.KEY_VIDEO_INFO_LIST_DATA, videoInfoListJSON)
  startActivity(intent)

• AUIShortVideoListFragment

  您可以將短劇列表播放Fragment嵌入到Activity頁面或者Fragment頁面中進行使用，具體調用邏輯可參考以下示例：

  1. 在XML布局文件中添加FrameLayout，用于承載Fragment：

     <FrameLayout
         android:id="@+id/fragment_container"
         android:layout_width="match_parent"
         android:layout_height="match_parent" />

  2. 在代碼中初始化Fragment并嵌入到容器。

     Java示例

     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         if (savedInstanceState == null) {
             AUIShortVideoListFragment fragment = new AUIShortVideoListFragment();
             Bundle bundle = new Bundle();
             // TODO: videoInfoListJSON is the serialized string of List<VideoInfo>
             bundle.putString(AUIShortVideoListView.KEY_VIDEO_INFO_LIST_DATA, videoInfoListJSON);
             fragment.setArguments(bundle);
             getSupportFragmentManager()
                     .beginTransaction()
                     .replace(R.id.fragment_container, fragment)
                     .commit();
         }
     }

     Kotlin示例

     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         if (savedInstanceState == null) {
             val fragment = AUIShortVideoListFragment()
             val bundle = Bundle()
             // TODO: videoInfoListJSON is the serialized string of List<VideoInfo>
             bundle.putString(AUIShortVideoListView.KEY_VIDEO_INFO_LIST_DATA, videoInfoListJSON)
             fragment.arguments = bundle
             supportFragmentManager
                 .beginTransaction()
                 .replace(R.id.fragment_container, fragment)
                 .commit()
         }
     }

• AUIShortVideoListView

  您可以利用短視頻列表播放View組件，構建一個沉浸式的列表播放頁面，具體調用邏輯可參考以下示例：

  1. 在 XML 布局文件中添加短劇列表播放 View 組件：

     <!--  1. Add Short Video List View Component  -->
     <com.alivc.player.playerkits.shortvideolist.AUIShortVideoListView
         android:id="@+id/aui_video_list_view"
         android:layout_width="match_parent"
         android:layout_height="match_parent" />

  2. 在代碼中聲明短視頻列表播放View組件，并添加List<VideoInfo> 數據源。

     Java示例

     // 2. Declaration of Short Video List View
     private AUIShortVideoListView mShortVideoListView;
     mShortVideoListView = findViewById(R.id.aui_video_list_view);
     
     // 3. TODO: Retrieve data and fill it into videoInfoList
     List<VideoInfo> videoInfoList;
     
     // 4. Add List<VideoInfo> type data source to Short Video List View
     mShortVideoListView.addSources(videoInfoList);
     // mShortVideoListView.loadSources(videoInfoList);

     Kotlin示例

     // 2. Declaration of Short Video List View
     private lateinit var mShortVideoListView: AUIShortVideoListView
     mShortVideoListView = findViewById(R.id.aui_video_list_view)
     
     // 3. TODO: Retrieve data and fill it into videoInfoList
     val videoInfoList: List<VideoInfo>
     
     // 4. Add List<VideoInfo> type data source to Short Video List View
     mShortVideoListView.addSources(videoInfoList)
     // mShortVideoListView.loadSources(videoInfoList)

AUIShortVideoList 組件使用的數據結構為List<VideoInfo>，其中VideoInfo為存儲視頻信息的數據類，其數據結構如下：

為了確保AUIShortVideoList組件正常運行，請通過Bundle傳遞已序列化的 List<VideoInfo> 字符串，以下是示例代碼：

intent.putExtra(AUIShortVideoListView.KEY_VIDEO_INFO_LIST_DATA, videoInfoListJSON);

您可以通過網絡請求或數據轉換這兩種方式，獲取最終的List<VideoInfo>數據源，并將其序列化為 JSON 字符串，示例如下：

• 網絡請求

  Java示例

  AUIShortVideoListUtil.requestVideoInfoList(new AUIShortVideoListUtil.OnNetworkCallBack<List<VideoInfo>>() {
      @Override
      public void onResponse(List<VideoInfo> videoInfoList) {
          if (videoInfoList == null || videoInfoList.isEmpty()) {
              // TODO: Request video info list error!
              return;
          }
          String videoInfoListJSON = AUIShortVideoListUtil.serializeVideoInfoListToJson(videoInfoList);
          // TODO: Use videoInfoList or videoInfoListJSON...
      }
  });

  Kotlin示例

  AUIShortVideoListUtil.requestVideoInfoList(object : AUIShortVideoListUtil.OnNetworkCallBack<List<VideoInfo?>?> {
      override fun onResponse(videoInfoList: List<VideoInfo?>?) {
          if (videoInfoList.isNullOrEmpty()) {
              // TODO: Request video info list error!
              return
          }
          val videoInfoListJSON = AUIShortVideoListUtil.serializeVideoInfoListToJson(videoInfoList)
          // TODO: Use videoInfoList or videoInfoListJSON...
      }
  })

• 數據轉換

  Java示例

  ArrayList<VideoInfo> videoInfoList = AUIShortVideoListUtil.assembleVideoInfoList();
  if (videoInfoList == null || videoInfoList.isEmpty()) {
      // TODO: Assemble video info list error!
      return;
  }
  String videoInfoListJSON = AUIShortVideoListUtil.serializeVideoInfoListToJson(videoInfoList);
  // TODO: Use videoInfoList or videoInfoListJSON...

  Kotlin示例

  val videoInfoList = AUIShortVideoListUtil.assembleVideoInfoList()
  if (videoInfoList.isNullOrEmpty()) {
      // TODO: Assemble video info list error!
      return
  }
  val videoInfoListJSON = AUIShortVideoListUtil.serializeVideoInfoListToJson(videoInfoList)
  // TODO: Use videoInfoList or videoInfoListJSON...

播放黑屏等異常情況

請檢查您的SDK License配置，詳情請參見Android端接入License。

編譯運行出現報錯

1. 請確保模塊中的配置，如 compileSdkVersion、buildToolsVersion、minSdkVersion、targetSdkVersion等，與您的項目中的設置保持一致。

2. 如果您的項目中已有相同第三方庫，請調整模塊中的版本號，以確保兼容性并避免沖突。

模擬器運行無法播放

Android播放器SDK不支持模擬器運行，集成完成后需要真機上進行測試。

錯誤“Namespace not specified”

請檢查您的 AGP 版本。如果為較新版本（如8.3.2），需要手動在各模塊 build.gradle 中添加 namespace 設置。舊版本 AGP 此配置位于模塊 /src/main/res/AndroidManifest.xml 中的 package 屬性。

Gradle 在處理 repository 的優先級時出現沖突

請優先在 setting.gradle 中添加 repository。

短劇劇場場景

概述

場景集成

使用方法

// TODO: context is android context
Intent intent = new Intent(context, AUIShortDramaListActivity.class);
startActivity(intent);

// TODO: context is android context
val intent = Intent(context, AUIShortDramaListActivity::class.java)
startActivity(intent)

獲取數據

短劇Feeds流場景

概述

場景集成

使用方法

// TODO: context is android context
Intent intent = new Intent(context, AUIShortDramaFeedsActivity.class);
startActivity(intent);

// TODO: context is android context
val intent = Intent(context, AUIShortDramaFeedsActivity::class.java)
startActivity(intent)

獲取數據

預加載

通過滑動窗口策略，動態啟停視頻的預加載任務。SDK底層基于網絡狀態智能調節任務優先級，以確保正播放視頻和即將播放視頻可以獲得更多的網絡資源，顯著提升視頻秒開率，減少播放卡頓。即使在快速滑動視頻時，仍然可以獲得流暢的播放體驗。更多信息，請參見預加載。

預渲染

使用預渲染的方式，在后臺提前渲染后續視頻的首幀，減少黑屏的出現，讓播放更加絲滑。音視頻終端 SDK和播放器SDK從6.16.0版本開始增添了對強制預渲染功能的支持。更多信息，請參見預渲染。

多實例播放器池

實現了全局共享的播放器實例池，可以靈活配置實例數。通過優化 API 調用和線程資源管控，確保在線程管理、CPU利用、內存占用等方面達到性能最優、資源最省，使性能和體驗達到最佳平衡。通過性能優化，減少了滑動過程中的耗時操作，減少滑動卡頓，讓播放體驗更加絲滑。

HTTPDNS

HTTPDNS可以提供更快速和穩定的DNS解析服務，通過替換傳統DNS解析，可以減少DNS解析時間，提高視頻播放的加載速度和穩定性，從而提升用戶的觀看體驗。音視頻終端SDK和播放器SDK從6.12.0版本開始無需手動開啟HTTPDNS。更多信息，請參見HTTPDNS。

視頻加密

微短劇場景的視頻通常為1~3分鐘的MP4格式視頻，音視頻終端SDK和播放器SDK從6.8.0版本開始支持MP4私有加密播放能力，為微短劇場景的視頻提供安全保障支撐。更多信息，請參見如何播放加密視頻。

經私有加密的MP4格式視頻，需滿足以下條件，才可正常播放：

• 經私有加密的MP4視頻傳給播放器播放時，業務側（App側）需要為視頻URL追加etavirp_nuyila=1，例如：原視頻URL為https://example.aliyundoc.com/test.mp4，則需要傳給播放器播放的視頻URL為https://example.aliyundoc.com/test.mp4?etavirp_nuyila=1。

• App的License對應的uid與產生私有加密MP4的uid是一致的。

如何校驗私有加密視頻是否正確，以私有加密的視頻URL為例說明如下：

• meta信息里面應帶有AliyunPrivateKeyUri的tag。

• ffplay不能直接播放。

H265自適應播放

當播放H265流硬解失敗且已設置H264備流時，實現自動降級播放H264備流；若未設置H264備流，則自動降級為H265軟解播放。更多信息，請參見H265自適應播放。

自適應ABR

播放器SDK支持多碼率自適應HLS、DASH視頻流，通過調用播放器的selectTrack方法切換播放的碼流，可以實現網絡自適應切換視頻清晰度的功能。更多信息，請參見自網絡自適應切換。

防錄屏

防錄屏通過監聽錄屏和截屏行為及時阻斷播放進程，有效保護視頻內容的版權，防止未經授權的盜錄和傳播。

// Android特有功能，禁止app錄屏和截屏
getWindow().setFlags(WindowManager.LayoutParams.FLAG_SECURE, WindowManager.LayoutParams.FLAG_SECURE);