環境要求

SDK下載

• Flutter SDK下載：Flutter SDK

• 阿里云Flutter播放器SDK最新版下載：阿里云播放器SDK

• 阿里云Flutter播放器SDK插件下載（播放器SDK的補丁版本更新）：阿里云Flutter播放器SDK插件

項目說明

Flutter播放器SDK原生層的開發基于Android播放器SDK和iOS播放器SDK。目前已將源碼通過Demo依賴的方式透出，開發者可以自行添加。

目錄文件名及功能說明如下表所示。

由于Flutter播放器SDK同時包含了直播及播放器功能。如果您的項目中不需要用到直播相關內容，您可以將Flutter播放器SDK內核從一體化（直播+ 播放器）改為單播放器，以上述Demo為例：

使用限制

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

集成操作

1. 啟動VS Code開發工具。

2. 選擇View > Command Palette… 。

3. 輸入flutter后，選擇Flutter: New Project。

4. 輸入Project名稱（如myapp），然后按回車鍵。

5. 指定放置項目的位置后，單擊藍色的確定按鈕。

   等待項目創建，直到顯示main.dart文件即表示項目創建完成。

6. 集成阿里云Flutter播放器SDK。

   您可以通過集成依賴的方式，在項目中的pubspec.yaml文件中引入flutter_aliplayer依賴，快速集成Flutter播放器SDK。

   dependencies:
     flutter_aliplayer: ^version
   # version為阿里云Flutter播放器SDK的版本號，例如：5.4.0。在使用時，請根據使用的版本進行變更。

7. 可選：如果業務需要支持超低延時直播RTS，請引用以下依賴。如需了解更多RTS的詳細信息，請參見超低延時直播簡介。

   您可以通過以下兩種方式實現：

   說明

   • 下述的版本號僅供參考，請以實際需要集成的版本號為準。

   • 阿里云播放器SDK和超低延時直播SDK的版本必須配套使用，具體版本配套關系請參見發布日志。

   • 阿里云播放器SDK的實際版本號請參見Android播放器SDK、iOS播放器SDK，超低延時直播SDK版本號請參見發布日志。

   • 方式一：在Android或iOS端原生層集成

     Android端集成：在build.gradle文件中添加依賴即可，示例如下。

     dependencies{
         implementation 'com.aliyun.sdk.android:AlivcArtc:$version'
         implementation 'com.aliyun.rts.android:RtsSDK:$version'
     }
     # version為版本號，分別為阿里云Android播放器SDK和超低延時直播SDK的版本號。例如：'com.aliyun.sdk.android:AlivcArtc:5.4.9.1','com.aliyun.rts.android:RtsSDK:2.5.0'

     iOS端集成：在Podfile文件中添加依賴即可，示例如下。

     target 'Runner' do
       flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
     
       pod 'AliPlayerSDK_iOS_ARTC', '$version'  #$version為阿里云iOS播放器SDK的版本號，例如：5.4.9.1
       pod 'RtsSDK', '$version'  #$version為阿里云超低延時直播SDK的版本號，例如：2.5.0
     
     end

   • 方式二：使用Flutter插件集成（此方式已停止更新，將不能獲取到最新版本SDK）

     超低延時直播SDK和阿里云播放器SDK的版本可以通過flutter_aliplayer項目中的CHANGELOG.md獲取。

      flutter_aliplayer_artc: ^version
      flutter_aliplayer_rts: ^version
     #  version為版本號。例如，flutter_aliplayer_artc: ^5.2.3， flutter_aliplayer_rts: ^1.5.0。在使用時，請根據使用的版本進行變更。

常見問題

在iOS系統上集成Flutter播放器SDK后，是否支持在Xcode模擬器上調試運行？