trtc_simple_demo_ios

English | 简体中文

跑通 Demo(Flutter)

本文主要介绍如何快速运行腾讯云 TRTC Demo（Flutter）。

注意：目前 Windows/MacOs 端仅支持音频，视频接口暂不支持；安卓/iOS 端支持视频通话

环境要求

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

前提条件

您已注册腾讯云账号，并完成实名认证。

操作步骤

[](id:step1)

步骤 1：创建新的应用

1. 登录实时音视频控制台，选择【开发辅助】>【快速跑通 Demo】。
2. 输入应用名称，例如APIExample；若您已创建过应用，可以勾选【选择已有应用】，然后单击【创建】。

[](id:step2)

步骤 2：下载 SDK 和 Demo 源码

1. 前往【Github】下载相关 SDK 及配套的 Demo 源码。
2. 下载完成后，返回实时音视频控制台，单击【已下载，下一步】，可以查看 SDKAppID 和密钥信息。

[](id:step3)

步骤 3：配置 Demo 工程文件

1. 解压 步骤 2 中下载的源码包。
2. 找到并打开/lib/debug/GenerateTestUserSig.dart文件。
3. 设置GenerateTestUserSig.dart文件中的相关参数：

• SDKAPPID：默认为 PLACEHOLDER ，请设置为实际的 SDKAppID。
• SECRETKEY：默认为 PLACEHOLDER ，请设置为实际的密钥信息。

1. 返回实时音视频控制台，单击【已复制粘贴，下一步】。
2. 单击【关闭指引，进入控制台管理应用】。

本文提到的生成 UserSig 的方案是在客户端代码中配置 SECRETKEY，该方法中 SECRETKEY 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量，因此该方法仅适合本地跑通 Demo 和功能调试。

正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端，并提供面向 App 的接口，在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见服务端生成 UserSig。

[](id:step4)

步骤 4：编译运行

1. 执行flutter pub get
2. 编译、运行或调试项目工程。

Android 调试：

1. 可以执行flutter run
2. 可以使用 Android Studio（3.5 及以上的版本）打开源码工程，单击【运行】即可。

iOS 调试：

1. 执行cd ios
2. 执行pod install
3. 使用 XCode（11.0 及以上的版本）打开源码目录下的 /ios 工程，编译并运行 Demo 工程即可。

windows 调试：

1. 启用 windows 支持：flutter config --enable-windows-desktop
2. 执行flutter run -d windows

macOS 调试

1. 启用 macOS 支持：flutter config --enable-macos-desktop
2. 执行cd macos
3. 执行pod install
4. 执行flutter run -d macos

如何查看 TRTC 日志？

TRTC 的日志默认压缩加密，后缀为 .xlog。

• iOS：sandbox 的 Documents/log
• Android
  • 6.7 及之前的版本：/sdcard/log/tencent/liteav
  • 6.8 之后的版本：/sdcard/Android/data/包名/files/log/tencent/liteav/

常见问题

更多常见问题参考文档

windows 运行报错

报错信息"Error waiting for a debug connection: The log reader stopped unexpectedly" 解决方案：请参照上面 windows 调试将两个缺失的 dll 引入进来

iOS 无法显示视频（Android 是好的）

请确认 io.flutter.embedded_views_preview 为YES在你的 info.plist 中

Android Manifest merge failed 编译失败

请打开/example/android/app/src/main/AndroidManifest.xml 文件。

1. 将 xmlns:tools="http://schemas.android.com/tools" 加入到 manifest 中
2. 将 tools:replace="android:label"加入到 application 中。

更新 SDK 版本后，iOS CocoaPods 运行报错？

1. 删除 iOS 目录下 Podfile.lock 文件。
2. 执行 pod repo update。
3. 执行 pod install。
4. 重新运行。