跑通 Demo

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


前提条件

环境准备

安装 Android Studio
两台 Android 5.0 以上的设备。

开通服务

请参见 开通服务,获取 SDKAppID 和 SDKSecretKey,在后续的步骤(配置并运行 Demo)中会用到。


下载 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 是否正确,确保它们是您在 开通服务 时获取到的密钥。

拨打电话过程中出现需要购买套餐包的提示?

错误提示
解决方法
您当前未购买音视频通话能力套餐,请前往 IM 控制台开通免费体验或加购正式版。
您当前未购买音视频通话能力套餐,请前往控制台 开通免费体验加购正式版
您当前购买的音视频通话能力套餐不支持该功能,建议您升级套餐类型。
您当前购买的音视频通话能力套餐不支持该功能,建议您前往控制台 升级套餐类型
提示:
如遇到其他错误提示,可查询 TUICallDefine 错误码 获取解决方案。若未找到解决方案,欢迎随时交流与反馈,我们将第一时间为您排查并解决。

交流与反馈

如果有任何需要或者反馈,您可以联系:info_rtc@tencent.com。