即时通信 IM uni-app(客户端)

这里说明如何快速跑通音视频通话 Demo。跟随这篇档,可以以在 10 分钟内跑通 Demo,并最终体验一个包含完备 UI 界面的音视频通话功能。

相关产品
即时通信 IM 产品页,含版本规格、价格与购买入口。

注意:说明:

注意:自 2025 年 5 月 1 日起,由于 uni-app 限制,CallKit 原生语言插件已终止迭代。为保障业务持续稳定运行,现提供 CallKit UTS 插件方案。CallKit UTS 插件核心优势:

一、环境准备

·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 是什么?

2. 打开 TUIKit_uni-app/App/debug/GenerateTestUserSig.js 文件,将上一步获取到的 SDKAppID 和 SDKSecretKey 填入其中:

// Your SDKAppIDlet SDKAppID = 0;// Your SDKSECRETKEYlet SDKSECRETKEY = "";

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

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

错误提示 解决方法
你当前未购买音视频通话能力套餐,请前往 IM 控制台开通免费体验或加购正式版。 你当前未购买音视频通话能力套餐,请前往 IM 控制台 开通免费体验 或 加购正式版。
你当前购买的音视频通话能力套餐不支持该功能,建议你升级套餐类型。 你当前购买的音视频通话能力套餐不支持该功能,建议你前往 IM 控制台 升级套餐类型。

九、运行项目为什么是白屏?

请检查是否制作了自定义基座。并且是否使用自定义基座运行了项目。

十、交流与反馈

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

赞 (0)
上一篇 4天前
下一篇 4天前