本文档主要介绍如何快速跑通 TUIRoomKit 研讨会场景 Demo,体验创建研讨会房间、音视频推流、屏幕共享、成员管理及超大规模消息互动在内的核心功能。跟随本文档,开发者可以在 10 分钟内跑通 Demo,并最终体验一个包含完备 UI 界面的研讨会房间功能。
标准会议与研讨会有何不同?
标准会议(Conference):适用于中小规模的多人协作场景,所有参与者均具有平等的音视频权限,提供屏幕共享、成员管理等完整互动能力。
研讨会(Webinar):专为大型直播演讲设计,支持无上限观众进房观看。观众可举手申请上台成为嘉宾后参与讨论,且系统针对万人级互动场景优化了消息并发性能,满足更专业的演讲互动需求。
功能展示
主持人 | 嘉宾 | 观众 |
支持主持人发起高清音视频推流与屏幕共享,支持对成员进行管理。 | 支持嘉宾开启麦克风进行实时语音讨论和分享。 | 支持观众无上限并发进房,以超低延迟观看实况并参与高频消息互动。支持观众通过“举手”功能向主持人申请变更为嘉宾。 |
![]() | ![]() | ![]() |
前提条件
开通服务
SDKAppID:应用标识,腾讯云基于
SDKAppID 完成计费统计。SDKSecretKey:应用密钥,用于初始化配置文件的密钥信息。
注意:
研讨会场景基于底层的直播能力构建。请注意体验研讨会能力需要领取 TUILiveKit 体验版或开通 TUILiveKit 正式版,以确保相关功能的正常运行。
环境准备
Android 5.0 (SDK API level 21)及以上。Gradle 8.0 及以上。两台
Android 5.0 以上的设备。需使用
JDK 17、18 或 19 版本。获取 Demo
1. 下载源码,您可以通过下列两种方式来获取 Demo:
直接在命令行运行以下命令:
git clone https://github.com/Tencent-RTC/TUIKit_Android
2. 打开工程:通过
Android Studio 打开 TUIKit_Android 项目:
配置 Demo
配置 SDKAppID 和 SDKSecretKey:打开
TUIKit_Android/application/debug/src/main/java/com/tencent/qcloud/tuikit/debug/GenerateTestUserSig.java文件,将获取的 SDKAppID 和 SDKSecretKey 填入:
编译并运行 Demo
1. 在
Android Studio 右上角如下图所示处选择您要将 Demo 运行的设备:

2. 选择完成后点击运行,将
TUIKit_Android 运行到目标设备上。

注意:
为了体验完整的研讨会房间流程,建议您将 Demo 分别在两台设备上运行并登录两个不同的用户(例如,一台设备作为房主,一台设备作为观众)。
登录和注册
Demo 启动后,请输入登录的用户 ID 。如果您当前的 ID 未曾注册过,会进入到注册界面,您可以在该界面为自己设置昵称。
登录页 | 注册页 |
![]() | ![]() |
提示:
请避免将 UserID 设置为“1”、“123”、“111”等简单字符串,以免多人协作时被他人占用导致登录失败。调试时建议设置具有辨识度的 UserID。
房间功能
登录成功后主页通过会议功能入口,通过 创建/进入 研讨会房间类型 进入 TUIRoomKit Demo 功能页面。
功能入口 | 房间主页 | 屏幕分享 | 成员管理面板 |
![]() | ![]() | ![]() | ![]() |
注意:
如果想用不同手机体验音视频互通场景,请确保在
TUIKit_Android/application/debug/src/main/java/com/tencent/qcloud/tuikit/debug/GenerateTestUserSig.java 文件中填写的 SDKAppID 是一致的。
常见问题
运行 Demo 提示签名错误或登录失败?
请检查您在
TUIKit_Android/application/debug/src/main/java/com/tencent/qcloud/tuikit/debug/GenerateTestUserSig.java 文件中填写的 SDKAppID 和 SDKSecretKey 是否正确,确保它们是您在 腾讯云控制台应用管理 页面获取到的密钥。Gradle 版本低于 8.0 会影响 Demo 运行吗?
是的, Gradle 版本过低,会导致依赖下载失败或编译错误,请您在 Android Studio 中升级 Gradle 版本至符合要求的范围。
编译报错:Unknown Kotlin JVM target 如何解决?
本地环境配置的 JDK 版本(例如 JDK 21)过高。
Demo 当前使用的 Kotlin 版本 (1.9) 尚不支持编译到该 JVM Target, 您需要将 Android Studio 的 Gradle JDK 设置修改为 17、18 或 19 版本。如何移除 Demo 中的通话和直播模块相关代码?
当前 Demo 为多功能集成示例,涵盖了腾讯云音视频的三大核心场景:通话(TUICallKit)、直播(TUILiveKit)和会议(TUIRoomKit)。若您的业务仅需会议场景,可通过以下步骤移除冗余模块代码,以精简项目结构和依赖:
1. 移除
settings.gradle 文件中 TUILiveKit 和 TUICallKit 依赖,并重新执行 SyncNow。2. 删除 Demo 工程中通话和直播场景相关代码。
3. 解决编译报错问题,编译并运行 Demo 工程。
联系我们
售前咨询
当需要购买咨询时,可以直接通过 售前咨询 进行提问,会有专属客户经理在线为您解答,提供专业的上云方案。同时也可以直接致电销售人员,咨询热线:4009100100转1(工作日9:00 - 18:00)。








