本文介绍如何集成 Flutter 拉流 SDK。

开发环境要求 #

• Flutter 版本：Flutter stable channel 3.0.0 及以上版本
• Dart 版本：Dart 2.17.0 及以上版本
• 系统版本：
  • 支持 iOS 11.0 及以上版本的真机
  • Android 5.0（minSdkVersion：21）及以上版本的真机
• 开发工具：推荐使用 Visual Studio Code 或 Android Studio 最新版本

前提条件 #

已创建 SDK 应用并获取 License 文件。详见获取 SDK License。

集成步骤 #

步骤一：添加依赖 #

1. 在 pubspec.yaml 文件中，添加 ve_live 依赖项，如下所示：

   dependencies:
     flutter:
       sdk: flutter
     ve_live: x.x.x
   

   说明

   将 x.x.x 替换为 SDK 的指定版本。推荐使用最新版本。版本号详见 Flutter 拉流 SDK 发布历史。

2. 打开终端窗口，并 cd 到您的 Flutter 项目目录。执行 flutter pub get 命令，获取项目所需的所有依赖，确保项目能够正常编译和运行。

步骤二：平台配置 #

为 Android 和 iOS 分别进行相应配置。

Android

1. 在 app 目录下的 AndroidManifest.xml 文件中声明 SDK 需要的权限。

   <!-- 摄像头权限 -->
   <uses-permission android:name="android.permission.CAMERA" />
   <!-- 录音权限 --> 
   <uses-permission android:name="android.permission.RECORD_AUDIO" />
   <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
   <!-- 网络状态权限 -->
   <uses-permission android:name="android.permission.INTERNET" />
   

2. 在 app 目录下的 proguard-rules.pro 文件中添加以下混淆规则。

   -keep class com.pandora.**{*;}
   -keep class com.ss.**{*;} 
   -keep class com.bytedance.**{*;}
   -keep class com.pandora.ttlicense2.**{*;}
   -keep class com.bytertc.**{*;}
   -keep class log.**{*;}
   

iOS

1. 在 Xcode 的 App Target 下，关闭 Bitcode。
   
   1. 单击 Build Settings 页签。
   2. 在 Build Options 区域，将 Enable Bitcode 置为 No。
2. 在 iOS 项目的 Podfile 文件中添加以下 Source。

   source 'https://github.com/cocoapods/Specs.git'
   source 'https://github.com/volcengine/volcengine-specs.git'
   

   说明

   建议使用 1.11.0 或更高版本的 CocoaPods。如果您的 iOS 项目尚未使用过 CocoaPods，在 iOS 项目根目录下，执行 pod init && pod install，可以得到 Podfile 文件。

3. 打开终端窗口，并 cd 到您的 iOS 项目目录。执行 pod install 命令。

步骤三：添加 License 文件 #

1. 将您获取到的 License 文件放入您的 Flutter 项目。此处以放入项目根目录下的assets 文件夹为例。

   ├── assets
   │   └── live.lic
   ├── pubspec.yaml
   

2. 在 pubspec.yaml 文件中的 assets 下，添加 License 文件的路径。

   assets:
     - assets/live.lic
   

3. 后续在初始化 SDK 时，需传入 License 文件的路径。详见初始化 Flutter 拉流 SDK。

后续操作 #

初始化 Flutter 拉流 SDK。详见初始化 Flutter 拉流 SDK。