微信小程序

最近更新时间:2025-11-07 17:29:22

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


前提条件

环境要求

微信 App iOS 最低版本要求:8.0.40。
微信 App Android 最低版本要求:8.0.40。
小程序基础库最低版本要求:2.10.0。

开通服务

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


下载 Demo

1. 打开终端,克隆仓库。
2. 安装依赖。
cd ./TUICallKit/MiniProgram/wechat-callkit-demo
npm install
3. 拷贝源码
Windows 端
Mac 端
xcopy node_modules\\@trtc\\calls-uikit-wx\\ .\\TUICallKit /i /e
xcopy node_modules\\@trtc\\call-engine-lite-wx\\RTCCallEngine.wasm.br .\\static\\
mkdir -p ./TUICallKit && cp -r node_modules/@trtc/calls-uikit-wx/ ./TUICallKit && mkdir -p ./static && cp node_modules/@trtc/call-engine-lite-wx/RTCCallEngine.wasm.br ./static/

跑通 Demo

推荐您将 Demo 运行在两台设备上使用两个用户登录,一方作为主叫,一方作为被叫,完成一次音视频通话体验。

步骤1:配置并运行 Demo

1. 打开 TUICallKit/debug/GenerateTestUserSig-es.js 文件,将开通服务时获取到对应的 SDKAppID 和 SDKSecretKey 填入其中。



2. 项目导入到微信开发者工具,构建 npm。打开微信开发者工具选择工具 > 构建 npm。具体如下图:

注意:
需要将 node_modules/@tencentcloud/lite-chat/basic.js 拷贝到 miniprogram_npm/@tencentcloud/lite-chat/basic.js。同时删除 miniprogram_npm/@tencentcloud/lite-chat/index.js 文件。
3. 在微信开发者工具中编译运行。


步骤2:登录

请您在用户ID 处输入 ID。



注意:
尽量避免使您的 UserID 被设置成“1”、“123”、“111”等简单字符串,由于 TRTC 不支持同一个 UserID 多端登录,所以在多人协作开发时,形如 “1”、“123”、“111” 这样的 UserID 很容易被您的同事占用,导致登录失败,因此我们建议您在调试的时候设置一些辨识度高的 UserID。

步骤3:拨打电话





常见问题

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

请检查您在 TUICallKit/debug/GenerateTestUserSig-es.js 文件中填写的 SDKAppID 和 SDKSecretKey 是否正确,确保它们是您在 开通服务 时获取到的密钥。

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

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

交流与反馈

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