跑通 Demo
本文将为您介绍如何快速跑通音视频通话 Demo。跟随本文档,您可以在 10 分钟内跑通 Demo,并最终体验一个包含完备 UI 界面的音视频通话功能。

前提条件
环境准备
安装 Android Studio。
两台 Android 5.0 以上的设备。
开通服务

下载 Demo
1. 从 GitHub 下载 TUICallKit Demo 源码,或者直接在命令行运行以下命令:
2. 通过 Android Studio 打开
TUICallKit/Android 目录:
提示:
目前 TUICallKit 已经适配 Gradle 7.x、8.x,如果您仍遇到如下问题:Your build is currently configured to use incompatible Java 21.0.5 and Gradle 8.0. Cannot sync the project.

推荐方案:将 Android Studio 的 Java 版本改为 17。
1. 打开 Android Studio 设置。
Windows:File > Settings
Mac:Android Studio > Preferences
2. 修改 Java 编译器设置。
路径:Build, Execution, Deployment > Build Tools > Gradle
将 Gradle JDK 改为 17(如果已安装)或 Use project JDK
跑通 Demo
通过 Android Studio 运行程序,将 Demo 分别在两台设备上使用两个用户登录,一方作为主叫,一方作为被叫,完成一次音视频通话体验。
步骤1:配置运行 Demo
1. 配置 SDKAppID 和 SecretKey:打开
Android/debug/src/main/java/com/tencent/qcloud/tuikit/debug/GenerateTestUserSig.java文件,将 开通服务 时获取到的 SDKAppID 和 SDKSecretKey 填入其中:

2. 编译运行:请选择设备并运行 Demo。

步骤2:登录和注册
Demo 启动后,请您在
用户ID处输入 ID 。如果您当前的 UserID 未曾注册过,会进入到注册界面,您可以在该界面为自己设置昵称。登录用户:Charlie | | 登录用户:Jane | |
![]() | ![]() | ![]() | ![]() |
提示:
建议您尽量避免将您的 UserID 设置成“1”、“123”、“111”等简单字符串,在多人协作开发时,形如 “1”、“123”、“111” 这样的 UserID 很容易被您的同事占用,导致登录失败,因此我们建议您在调试的时候设置一些辨识度高的 UserID。
步骤3:拨打电话
1. 主叫方请点击界面上的 1V1 通话,在弹出的界面中输入被叫方的 UserID 并选择您想要的通话类型。
2. 单击发起通话。
Charlie 呼叫 Jane | Jane 收到来电 | Jane 点击"接听"后双方开始通话 |
![]() | ![]() | ![]() |
提示:
发起通话需确认:被呼叫用户 ID 是已登录的有效 ID。
常见问题
运行 Demo 提示签名错误或登录失败?
请检查您在
TUIKit_Android/application/debug/src/main/java/com/tencent/qcloud/tuikit/debug/GenerateTestUserSig.java 文件中填写的 SDKAppID 和 SDKSecretKey 是否正确,确保它们是您在 开通服务 时获取到的密钥。拨打电话过程中出现需要购买套餐包的提示?
提示:
交流与反馈
如果有任何需要或者反馈,您可以联系:info_rtc@tencent.com。






