HarmonyOS

最近更新时间:2026-06-09 16:54:09

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







前提条件

环境准备

集成开发环境:6.0.0.858 或以上。
手机操作系统:HarmonyOS 5.0.5 或以上。
API Version:17 或以上。

开通服务

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


下载 Demo

1. 从 GitHub 下载 TUICallKit Demo 源码,或者直接在命令行运行以下命令:
git clone https://github.com/Tencent-RTC/TUIKit_Harmony.git
2. 通过 DevEco Studio 打开 TUIKit_Harmony/application_call 项目:


跑通 Demo

通过 DevEco Studio 运行程序,将 Demo 分别在两台设备上使用两个用户登录,一方作为主叫,一方作为被叫,完成一次音视频通话体验。

步骤1:配置并运行 Demo

1. 配置 SDKAppID 和 SecretKey:打开 application_call/entry/src/main/ets/debug/GenerateTestUserSig.ts 文件,将 开通服务 时获取到的 SDKAppID 和 SDKSecretKey 填入其中:

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


步骤2:登录和注册

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




提示:
建议您尽量避免将您的 UserID 设置成 "1"、"123"、"111" 等简单字符串",在多人协作开发时,此类 UserID 容易被同事占用导致登录失败,建议在调试时设置辨识度高的 UserID 。

步骤3:拨打电话

1. 主叫方请点击界面上的 通话,跳转界面后,在 用户 ID 列表 填写被叫用户的 ID,并选择 媒体类型
2. 单击发起通话
点击"通话"
Charlie 呼叫 Jane
Jane 收到来电
Jane 点击"接听"后双方开始通话




提示:
发起通话需确认:被呼叫用户 ID 是已登录的有效 ID。

常见问题

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

请检查您在 application_call/entry/src/main/ets/debug/GenerateTestUserSig.ts 文件中填写的 SDKAppID 和 SDKSecretKey 是否正确,确保它们是您在 开通服务 时获取到的密钥。

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

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

交流与反馈

如果您在使用过程中,有什么建议或者意见,可以 联系我们,感谢您的反馈。