futter.md

本文主要介绍如何快速地将腾讯云视立方集成到您的项目中，按照如下步骤进行配置，就可以完成腾讯云视立方SDK在Flutter端的集成工作，主要包含超级播放器和音视频通话TRTC的集成方式。

版本支持

本页文档所描述功能，在腾讯云视立方中支持情况如下：

版本名称	基础直播 Smart	互动直播 Live	短视频 UGSV	音视频通话 TRTC	播放器 Player	全功能
支持情况	-	-	-	✓	✓	-
SDK 下载	下载	下载	下载	下载	下载	下载

不同版本 SDK 包含的更多能力，具体请参见 SDK 下载。

Flutter超级播放器集成方式

腾讯云视立方Flutter超级播放器是基于超级播放器的一个Flutter 插件，同时支持 Android 和 iOS 两个平台。完全免费开源，不对播放地址来源做限制，可放心使用。

• Flutter超级播放器具体集成方式参见Flutter超级播放器。

Flutter音视频TRTC集成方式

! 目前 Windows/MacOs 端仅支持音频，视频接口暂不支持。Android/iOS 端支持视频通话。

环境要求

• Flutter 2.0 及以上版本。
• Android 端开发：
  • Android Studio 3.5及以上版本。
  • App 要求 Android 4.1及以上版本设备。
• iOS & macOS 端开发：
  • Xcode 11.0及以上版本。
  • osx 系统版本要求 10.11 及以上版本
  • 请确保您的项目已设置有效的开发者签名。
• Windows 开发：
  • 操作系统：Windows 7 SP1 或更高的版本（基于 x86-64 的 64 位操作系统）。
  • 磁盘空间：除安装 IDE 和一些工具之外还应有至少 1.64 GB 的空间。
  • 安装 Visual Studio 2019。

集成 SDK

Flutter SDK 已经发布到 pub 库，您可以通过配置 pubspec.yaml 自动下载更新。

1. 在项目的 pubspec.yaml 中写如下依赖：

dependencies:
  tencent_trtc_cloud: 最新版本号

2. 开通摄像头和麦克风的权限，即可开启语音通话功能。

::: iOS\s端 1. 需要在 `Info.plist` 中加入对相机和麦克风的权限申请： ``` NSCameraUsageDescription 授权摄像头权限才能正常视频通话 NSMicrophoneUsageDescription 授权麦克风权限才能正常语音通话 ``` 2. 添加字段 `io.flutter.embedded_views_preview`，并设定值为 YES。 ::: ::: macOS\s端 1. 需要在 `Info.plist` 中加入对相机和麦克风的权限申请： ``` NSCameraUsageDescription 授权摄像头权限才能正常视频通话 NSMicrophoneUsageDescription 授权麦克风权限才能正常语音通话 NSPhotoLibraryUsageDescription App需要您的同意,才能访问相册 ``` 2. 需要在 `macos/Runner/*.entitlements` 文件中添加`com.apple.security.network.client` 、 `com.apple.security.network.server` 添加后如下图所示：  3. 单击 Link Binary with Libraries 项展开，单击底下的+号图标去添加依赖库。  4. 添加其所需依赖库：`libbz2.1.0.tbd` 。 添加后如下图所示：  :::

::: Android\s端

1. 打开 /android/app/src/main/AndroidManifest.xml 文件。
2. 将 xmlns:tools="http://schemas.android.com/tools" 加入到 manifest 中。
3. 将 tools:replace="android:label" 加入到 application 中。

? 若不执行此步，会出现 Android Manifest merge failed 编译失败 问题。

:::

::: Windows\s端

1. 启用 Windows 支持：flutter config --enable-windows-desktop。
2. flutter run -d windows。 :::

常见问题

• iOS 打包运行 Crash？
• iOS 无法显示视频（Android 正常）？
• 更新 SDK 版本后，iOS CocoaPods 运行报错？
• Android Manifest merge failed 编译失败？
• 因为没有签名，真机调试报错?
• 对插件内的 swift 文件做了增删后，build 时查找不到对应文件？
• Run 报错“Info.plit, error: No value at that key path or invalid key path: NSBonjourServices”？
• Pod install 报错？
• Run 的时候 iOS 版本依赖报错？