Flutter

最近更新时间:2026-03-16 17:57:02

我的收藏
本文档主要介绍如何快速跑通 TUIRoomKit 示例工程,体验高质量多人视频会议。跟随本文档,您可以在 10 分钟内跑通 Demo,并最终体验一个包含完备 UI 界面的多人视频会议功能。


前提条件

开通服务
请参考 开通服务创建一个 Room 应用,并获取以下信息:
SDKAppID:App 在控制台获取的 Room 应用的 ID,为应用的唯一标识。
SDKSecretKey:应用的密钥。
环境准备
平台
版本
Flutter
3.29.3 及以上版本。
Android
最低兼容 Android 5.0 (SDK API Level 21)及以上版本。
iOS
iOS 14.0 及更高。

获取 Demo

1. 下载源码,你可以通过下列两种方式来获取 Demo:
克隆项目到本地
下载 Demo 并解压
在命令行中运行以下命令:
git clone https://github.com/Tencent-RTC/TUIKit_Flutter
下载 TUIKit_Flutter Demo,完成解压。
2. 通过 Android Studio 或 VSCode 打开 TUIKit_Flutter 的 application 目录。后续流程将以 VSCode 为例:


配置 Demo

1. 配置 SDKAppID 和 SDKSecretKey:打开工程,在工程内找到 application/lib/debug/generate_test_user_sig.dart 文件。将获取到的对应的 SDKAppID SDKSecretKey 填入其中:



注意:
本文的 Demo 示例中通过在客户端代码中配置 SDKSecretKey 进行鉴权,但 SDKSecretKey 很容易被反编译逆向破解,一旦密钥泄露,攻击者就可以盗用您的腾讯云流量,因此该方法仅适合本地跑通 Demo 和功能调试。
在正式的生产环境中,建议在您的服务端生成 UserSig,在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig 来进行鉴权。详见服务端生成 UserSig

编译并运行 Demo

多人会议场景通常会使用到摄像头、麦克风设备,因此建议您使用真机调试和运行 Demo。
1. 使用 VSCode 打开application/lib/main.dart,点击右下角的设备连接按钮。在上方弹出的弹框中选择需要运行的设备。选择后点击右上角的运行按钮,即可将TUIKit_Flutter Demo运行在设备上。

2. 您也可以在application目录下,执行以下命令以在您的设备上运行。
flutter run
提示:
为了体验完整的会议房间流程,建议您将 Demo 分别在两台设备上运行并登录两个不同的用户(例如,一台设备作为房主,一台设备作为参会者)。

登录和注册

Demo 启动后,请输入登录的用户 ID 。如果您当前的 ID 未曾注册过,会进入到注册界面,您可以在该界面为自己设置昵称。
登录页
注册页






提示:
请避免将 UserID 设置为“1”、“123”、“111”等简单字符串,以免多人协作时被他人占用导致登录失败。调试时建议设置具有辨识度的 UserID。

房间功能

登录成功后在主页通过会议功能入口进入 TUIRoomKit Demo 功能页面。
功能入口
标准房间主页
网络研讨会主页
成员管理面板












注意:
如果想用不同手机体验音视频互通场景,请确保在application/lib/debug/generate_test_user_sig.dart文件中填写的 SDKAppID 是一致的。

常见问题

运行 Demo 提示签名错误或登录失败?

请检查您在 application/lib/debug/generate_test_user_sig.dart 文件中填写的 SDKAppID 和 SDKSecretKey 是否正确,确保它们是您在 开通服务 时获取到的密钥。

如何移除 Demo 中的通话、直播和聊天模块相关代码?

当前 Demo 为多功能集成示例,涵盖了腾讯云音视频的四大核心场景:通话(TUICallKit)、直播(TUILiveKit)、会议(TUIRoomKit)和聊天(TUIKit)。若您的业务仅需会议场景,可通过以下步骤移除冗余模块代码,以精简项目结构和依赖:
1. 移除 pubspec.yaml 文件中 tencent_live_uikittencent_calls_uikittencent_chat_uikit 的依赖,并重新执行 flutter pub get 命令。
2. 删除 Demo 工程中通话、直播和聊天场景相关代码。
3. 解决编译报错问题,编译并运行 Demo 工程。

联系我们

售前咨询

当需要购买咨询时,可以直接通过 售前咨询 进行提问,会有专属客户经理在线为您解答,提供专业的上云方案。同时也可以直接致电销售人员,咨询热线:4009100100转1(工作日9:00 - 18:00)。

售后支持

当遇到问题需要处理时,可以直接通过 售后支持 进行提问,腾讯云工程师7 × 24小时在线为您提供服务。同时也可以直接致电客服人员,寻求相应的帮助,客服咨询:4009100100(7 × 24小时)。