本文檔詳細介紹了AliPlayerWidget的整合步驟和前提條件，協助開發人員快速上手使用該組件。
前提條件
開發環境配置
在使用 AliPlayerWidget 之前，請確保您的開發環境滿足以下要求：
Flutter SDK
版本要求不低於
2.10.0，推薦版本為3.22.2。運行
flutter doctor檢查並解決所有問題。
JDK 11
說明JDK 11設定方法：Preferences -> Build, Execution, Deployment -> Build Tools -> Gradle -> Gradle JDK -> 選擇 11（如果沒有11，請升級你的Android Studio版本）。
Android 開發環境
安裝最新版本的 Android Studio。
配置 Android SDK，最低支援 API 層級為 21（Android 5.0）。
Gradle 版本不低於
7.0。
iOS 開發環境
安裝最新版本的 Xcode。
配置 CocoaPods，推薦版本為
1.13.0。最低支援 iOS 版本為
10.0。
許可權配置
許可權配置
在 Android 和 iOS 中啟用網路許可權，以便播放器能夠載入線上視頻資源。
License 配置
您已擷取播放器SDK的 License 授權認證和 License Key，詳情請參見管理License。
注意：如未正確配置 License，播放器將無法正常工作，並可能拋出授權異常。
更多初始化配置，請參考 aliplayer_widget_example 樣本工程。
樣本 Demo
為了協助開發人員快速體驗 AliPlayerWidget 的功能，我們基於 aliplayer_widget_example 樣本工程構建了一個示範包。該示範包可以直接安裝到裝置上運行，無需額外配置開發環境。
擷取方式
使用手機掃描以下二維碼，即可快速下載並安裝示範包：
注意：二維碼連結指向最新版本的示範包，請確保您的裝置已開啟允許安裝第三方應用的許可權。
SDK 整合與下載
aliplayer_widget 已經開源並提供多種下載方式。如果您需要對組件進行自訂修改，您可以使用源碼依賴的方式，直接擷取並修改源碼。完整源碼可通過以下方式擷取：
下載說明 | 下載地址 |
Pub 源 |
說明 aliplayer_widget 推薦開發人員通過包管理工具整合 |
GitHub | |
源碼包 |
下載包的內容包括：
核心組件：
AliPlayerWidget和AliPlayerWidgetController的完整實現。樣本工程：
aliplayer_widget_example提供點播、直播、列表播放等情境的程式碼範例，協助開發人員快速整合和使用。文檔與注釋：源碼包含詳細注釋和開發指南，便於二次開發與定製。
添加依賴
aliplayer_widget 內部已依賴 flutter_aliplayer。大多數情境下，您只需添加 aliplayer_widget 即可。如果您需要直接使用底層 API（如 MediaLoader 預先載入），可額外顯式聲明 flutter_aliplayer。
SDK 版本說明
aliplayer_widget 預設使用播放器獨立 SDK 版本。
情境 | 推薦版本 | 說明 |
僅需播放能力 | 普通播放器 SDK（推薦） | 使用 |
推流 + 播放 | interactivelive 特殊版 | 僅建議在同時整合 |
非必要情況下，請不要使用 interactivelive 特殊版本。如果專案僅使用播放能力，請固定使用普通播放器 SDK 完整版本號碼，避免不必要地引入一體化 SDK，造成依賴複雜度增加或潛在 SDK 衝突。
可以通過以下任一方式添加依賴：
方式一：使用命令列添加（推薦）
在專案根目錄下執行以下命令：
# 必須
flutter pub add aliplayer_widget
# 可選：僅當您需要直接使用 flutter_aliplayer 底層 API 時添加
flutter pub add flutter_aliplayer方式二：手動添加
在pubspec.yaml檔案的dependencies 部分添加以下內容：
dependencies:
# 必須
aliplayer_widget: <latest_version>
# 可選：僅當您需要直接使用 flutter_aliplayer 底層 API 時添加
flutter_aliplayer: <latest_version>擷取依賴並構建專案
添加依賴後，需要擷取依賴並構建專案：
擷取依賴包（如果使用手動添加方式）。
flutter pub getiOS平台額外步驟（僅限iOS）。
cd ios pod install cd ..構建專案。
構建Android APK：
flutter build apk構建iOS應用：
flutter build ios構建跨平台 app：
flutter build
完成以上步驟後，您就可以開始使用AliPlayerWidget進行視頻播放開發了。如需瞭解具體的使用方法，請參考快速開始。