本文将为您介绍如何快速跑通音视频通话 Demo。跟随本文档，您可以在 10 分钟内跑通 Demo，并最终体验一个包含完备 UI 界面的音视频通话功能。
说明：
自 2025 年 5 月 1 日起，由于 uni-app 官方限制，CallKit 原生语言插件已终止迭代。为保障业务持续稳定运行，现提供 CallKit UTS 插件方案。CallKit UTS 插件核心优势：
支持自定义 UI，深度界面定制。
支持 uni-app 及 uni-app x 项目。
提供插件版本锁定功能，避免因更新导致兼容性问题。
环境准备
HBuilderX：HBuilderX 是 uni-app 官方的集成开发环境（IDE），我们需要用它来导入、配置和运行我们的 Demo。
两个移动设备：Android 5.0 以上的设备 / iOS 13.0 及以上设备。
说明：
HBuilderX 4.64 和 4.65 版本对 UTS 插件打包存在已知兼容性问题，建议使用 4.75 或更高版本。
操作步骤
步骤 1：下载 Demo
1. 下载源码。
git clone https://github.com/Tencent-RTC/TUIKit_uni-app.gitcd TUIKit_uni-app/App
2. 使用 HBuilderX 导入
TUIKit_uni-app/App。在 HBuilderX 顶部菜单栏选择文件 > 导入 > 从本地目录导入，然后精确选择刚才克隆的
TUIKit_uni-app/App 文件夹，单击导入。
步骤 2：配置 Demo
1. 请参见 开通服务（TUICallKit），领取体验版或者开通付费版。成功后即可获得14天的体验版，可免费体验 TUICallKit 的全部功能，并获取 SDKAppID 和 SDKSecretKey 。
说明：
SDKAppID 和 SDKSecretKey 是什么？
SDKAppID：应用的唯一标识，相当于您在腾讯云音视频服务中的“身份证号”。
SDKSecretKey：用于签发 UserSig（用户签名）的密钥，能确保只有您的应用才能使用腾讯云的服务，防止被盗用。请务必妥善保管，不要泄露。
2. 打开 TUIKit_uni-app/App/debug/GenerateTestUserSig.js 文件，将上一步获取到的
SDKAppID 和 SDKSecretKey 填入其中：// Your SDKAppIDlet SDKAppID = 0;// Your SDKSECRETKEYlet SDKSECRETKEY = "";
步骤 3：跑通 Demo
1. 制作自定义调试基座
制作自定义调试基座，在 HBuilderX 顶部菜单栏选择运行 > 运行到手机或模拟器 > 制作自定义调试基座。HBuilderX 会开始打包，这需要一些时间。
说明：
为什么要制作自定义调试基座？
因为我们的音视频通话 Demo 使用了原生的音视频能力（通过 UTS 插件实现），这超出了 HBuilderX 标准基座（一个通用的 App 壳子）的功能范围。因此，我们需要制作一个包含了这些原生插件的“专属”运行环境，这就是“自定义调试基座”。
2. 使用自定义基座运行项目
使用自定义基座运行项目，基座制作成功后，HBuilderX 控制台会有提示。然后，再次单击顶部菜单运行 > 运行到手机或模拟器，在弹出的设备选择窗口中，务必勾选使用自定义调试基座，然后选择您的真机设备并单击运行。
步骤 4：拨打电话
1. 登录/注册 userID（由您定义）。
注意：
TUICallKit 不支持同一个 UserID 多端登录，在多人协作开发时， “1”、“123”、“111” 这种简单的 UserID 很容易被占用，导致登录失败，因此建议在调试时设置辨识度较高的 UserID。为了使您可以体验完整的音视频通话流程，请将 Demo 分别在两台设备上登录两个用户，一方作为主叫，一方作为被叫。
2. 选择通话场景并选择通话类型。
选择通话场景 | 选择通话类型 |
 |  |
3. 输入被叫的 UserID，点击搜索，然后进行呼叫。
常见问题
运行 Demo 提示签名错误或登录失败？
请检查您在 TUIKit_uni-app/App/debug/GenerateTestUserSig.js 文件中填写的 SDKAppID 和 SDKSecretKey 是否正确，确保它们是您在 开通服务 时获取到的密钥。
拨打电话过程中出现需要购买套餐包的提示？
运行项目为什么是白屏？
请检查是否制作了自定义基座。并且是否使用自定义基座运行了项目。
