tencent cloud

实时音视频

Android

Download
聚焦模式
字号
最后更新时间: 2026-05-08 16:36:52
本文档主要介绍如何快速跑通 TUIRoomKit 视频会议 Demo,体验高质量多人视频会议。跟随本文档,开发者可以在 10 分钟内跑通 Demo,并最终体验一个包含完备 UI 界面的多人视频会议功能。
房间准备页
房间主页
成员管理










前提条件

开通服务
请参考 开通服务 领取 TUIRoomKit 体验版,获取 SDKAppIDSDKSecretKey
SDKAppID:App 在控制台获取的 Room 应用的 ID,为应用的唯一标识。
SDKSecretKey:应用的密钥。

环境准备

Android 5.0 (SDK API level 21)及以上。
Gradle 8.0 及以上。
两台 Android 5.0 以上的设备。
需使用 JDK 17、18 或 19 版本。

获取 Demo

1. 下载源码,您可以通过下列两种方式来获取 Demo:
克隆项目到本地
下载 Demo 并解压
在命令行中运行以下命令:
git clone https://github.com/Tencent-RTC/TUIKit_Android
下载 TUIKit_Android Demo,并进行解压。
2. 打开工程:通过 Android Studio 打开 TUIKit_Android 项目:


配置 Demo

配置 SDKAppID 和 SDKSecretKey:打开 TUIKit_Android/application/debug/src/main/java/com/tencent/qcloud/tuikit/debug/GenerateTestUserSig.java 文件,将获取的 SDKAppIDSDKSecretKey 填入:


编译并运行 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 文件中填写的 SDKAppIDSDKSecretKey 是否正确,确保它们是您在 腾讯云控制台 > 应用管理 页面获取到的密钥。

Gradle 版本低于 8.0 会影响 Demo 运行吗?

是的,Gradle 版本过低,会导致依赖下载失败或编译错误,请您在 Android Studio 中升级 Gradle 版本至符合要求的范围。

编译报错:Unknown Kotlin JVM target 如何解决?

本地环境配置的 JDK 版本(如 JDK 21)过高。Demo 当前使用的 Kotlin 版本 (1.9) 尚不支持编译到该 JVM Target, 您需要将 Android StudioGradle JDK 设置修改为 17、18 或 19 版本。

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

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

联系我们

如果您在接入或使用过程中有任何疑问或建议,您可以联系 info_rtc@tencent.com 提交反馈。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈