快速集成

环境要求

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模拟器上调试运行？