本文主要介绍如何快速运行腾讯云 TRTC-Simple-Demo(Flutter)。
环境要求
Flutter 3.22 及以上版本。
Android 端开发:
Android Studio 3.5及以上版本。
App 要求 Android 4.1及以上版本设备。
iOS 端开发:
Xcode 13.0及以上版本。
请确保您的项目已设置有效的开发者签名。
Windows 端开发:
Visual Studio 2019及以上版本。
Mac 端开发:
Xcode 13.0及以上版本。
前提条件
操作步骤
步骤1:创建新的应用
1. 登录实时音视频控制台,选择开发辅助 > 快速跑通 Demo。
2. 单击新建应用输入应用名称,例如
TestTRTC;若您已创建应用可单击选择已有应用。3. 根据实际业务需求添加或编辑标签,单击创建。

说明:
应用名称只能包含数字、中英文字符和下划线,长度不能超过15个字符。
标签用于标识和组织您在腾讯云的各种资源。例如:企业可能有多个业务部门,每个部门有1个或多个 TRTC 应用,这时,企业可以通过给 TRTC 应用添加标签来标记部门信息。标签并非必选项,您可根据实际业务需求添加或编辑。
步骤2:下载 SDK 和 Demo 源码
1. 根据实际业务需求下载 SDK 及配套的 Demo 源码。
2. 下载完成后,单击 已下载,下一步。

步骤3:配置 Demo 工程文件
进入已下载 Demo 源码中的 TRTC-Simple-Demo 目录,该工程主要结构如下:
TRTC-Simple-Demo/├── lib/│ ├── main.dart # 应用入口│ ├── debug/│ │ └── GenerateTestUserSig.dart # ⚠️ 核心配置文件(需修改)│ ├── models/ # 数据模型 & 状态管理│ ├── ui/ # 页面:登录、会议、设置、API测试│ └── utils/ # 工具类├── android/ # Android 平台├── ios/ # iOS 平台├── macos/ # macOS 平台├── windows/ # Windows 平台├── pubspec.yaml # 依赖配置└── README-zh_CN.md # 中文说明
1. 根据步骤2,点击 已下载,下一步按钮后进入如下修改配置界面:

2. 在本地 Demo 工程中找到并打开 TRTC-Simple-Demo/lib/debug/GenerateTestUserSig.dart 文件。
3. 设置 GenerateTestUserSig.dart 文件中的相关参数:
sdkAppId:默认为0,请设置为实际的 SDKAppID。
secretKey:默认为空字符串,请设置为实际的密钥信息 SDKSecretKey。


4. 粘贴完成后,单击已复制粘贴,下一步即创建成功。
说明:
本文提到的生成 UserSig 的方案是在客户端代码中配置 SDKSecretKey,该方法中 SDKSecretKey 很容易被反编译逆向破解,一旦您的密钥泄露,攻击者就可以盗用您的腾讯云流量,因此该方法仅适合本地跑通 Demo 和功能调试。
正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端,并提供面向 App 的接口,在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig。
步骤4:编译运行
1. 打开终端,进入 TRTC_Flutter/TRTC-Simple-Demo 目录:
cd TRTC-Simple-Demo
2. 通用步骤(所有平台)
# 安装 Flutter 依赖flutter pub get
3. 各平台编译
查看 Android 可用设备
flutter devices
编译运行(替换 <device_id> 为实际设备 ID)
flutter run -d <device_id>
进入 ios 目录安装 CocoaPods 依赖
cd iospod install
用 Xcode 打开 ios/Runner.xcworkspace,配置好您的签名信息选择设备后编译运行。
开启开发者模式:
Windows 上 Flutter 插件依赖符号链接(symlink),而创建 symlink 需要管理员权限或开启「开发者模式」
开启方法:
1. 在 PowerShell / 运行框执行:start ms-settings:developers
2. 在打开的设置页里,把 开发者模式(Developer Mode) 开关打开
执行编译或者编译完直接运行命令:
flutter build windows // 只编译不运行flutter run -d windows // 编译完成自动运行
flutter build macos --debug // 只编译不运行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/。iOS 无法显示视频(Android 没问题)?
请确认在您的 info.plist 中,
io.flutter.embedded_views_preview 是否为 YES。 AndroidManifest merge failed 编译失败?
请打开
/example/android/app/src/main/AndroidManifest.xml 文件。1. 将
xmlns:tools="http://schemas.android.com/tools" 加入到 manifest 中。2. 将 
tools:replace="android:label" 加入到 application 中。

说明: