本文档介绍如何快速运行 Flutter 版 TRTC 示例。

环境要求

  • Flutter 2.0 或更高版本
  • Android 开发
    • Android Studio 3.5 或更高版本
    • Android 4.1 或更高版本设备
  • iOS 开发
    • Xcode 11.0 或更高版本
    • OS X 10.11 或更高版本
    • 您的项目需要有效的开发者签名

先决条件

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

操作步骤

步骤 1：创建应用

  1. 登录 TRTC 控制台，选择辅助开发 > Demo 快速跑通。
  2. 单击创建应用，并输入应用名称，例如 TestTRTC。如果您已创建应用，请单击选择现有应用。
  3. 根据您的实际业务需求，添加或编辑标签，然后单击创建。

?

  • 应用名称最多可输入 15 个字符。仅允许包含数字、字母、中文及下划线。
  • 标签用于识别和组织您的腾讯云资源。例如，一个企业可能有多个业务部门，每个部门下有一个或多个 TRTC 应用。此时，企业可通过标签来标识出部门信息。标签为选填项，您可以根据实际业务需求添加或编辑。

步骤 2：下载 SDK 和 Demo 源码

  1. 下载对应平台的 SDK 及 Demo 源码。
  2. 单击下一步。

步骤 3：配置 Demo 工程文件

  1. 在修改配置环节，根据您下载的源码包选择对应的开发平台。
  2. 找到并打开 /example/lib/debug/GenerateTestUserSig.dart。
  3. 按如下方式设置 GenerateTestUserSig.dart 中的参数。
  • SDKAPPID：默认是一个占位符。请将其替换为您的实际 `SDKAppID`。
  • `SECRETKEY`：默认是一个占位符。请将其替换为您的实际密钥。

  1. 单击下一步完成创建。
  2. 编译完成后，单击返回概览页。

?

  • 本文档中介绍的生成 UserSig 的方法，是通过在客户端代码中配置 SECRETKEY。这种方法SECRETKEY 容易被反编译，泄漏后可能导致腾讯云流量被盗用。因此，**该方法仅适用于 Demo 的本地运行和调试**。
  • 正确的 UserSig 分发方式是将 UserSig 的计算代码集成到您的服务端，并提供给 App 端一个调用 API。当 App 需要 UserSig 时，可以向业务服务器发起请求，动态获取 UserSig。更多详情请参见 如何计算 UserSig？。

步骤 4：编译运行

  1. 运行 flutter pub get。
  2. 编译、运行并调试项目。

Android

  1. 运行 flutter run。
  2. 使用 Android Studio (3.5 及以上版本) 打开 Demo 工程，点击运行。

iOS

使用 Xcode (11.0 及以上版本) 打开源码目录中的 /ios Demo 工程，编译运行 Demo 工程。

常见问题

如何查看 TRTC 日志？

TRTC 日志默认以 .xlog 为后缀进行压缩和加密，地址如下：

  • iOS：沙盒中的 Documents/log 目录。
  • Android:
    • 6.7 及以下版本：/sdcard/log/tencent/liteav。
    • 6.8 及以上版本：/sdcard/Android/data/package name/files/log/tencent/liteav/。

iOS 画面不显示，但 Android 画面正常显示怎么办？

请检查您的 info.plist 中 io.flutter.embedded_views_preview 是否设置为 YES。

Android Studio 构建项目时报错 “Manifest merge failed” 怎么办？

打开 /example/android/app/src/main/AndroidManifest.xml。
1. 在 manifest 标签下添加 xmlns:tools="http://schemas.android.com/tools"。
2. 在 application 标签下添加 tools:replace="android:label"。
Illustration

更多常见问题，请参见 Flutter。

GitHub

查看 Github