有奖捉虫:办公协同&微信生态&物联网文档专题 HOT
TUIKit(vue2/vue3)组件具备单人视频通话和语音通话功能,并且实现了小程序端和 Web 端、App 端全平台的互通。

环境准备

HbuilderX 版本要求:HbuilderX 版本 ≥ 3.94。
iOS 9.0 或以上版本且支持音视频的 iOS 设备,暂不支持模拟器。
Android 版本不低于 4.4 且支持音视频的 Android 设备,暂不支持模拟器。如果为真机,请开启允许调试选项。最低兼容 Android 4.4(SDK API Level 16),建议使用 Android 5.0 (SDK API Level 21)及以上版本。
iOS/Android 设备已经连接到 Internet。
音视频通话界面如下图所示:
语音通话
视频通话







步骤1:开通服务

在使用腾讯云提供的音视频服务前,您需要前往控制台,为应用开通音视频服务。具体步骤请参考开通服务。

步骤2:导入插件

注意:
请确保在导入 TUICallKit 插件前您已集成 chat-uikit-uniapp
1. 购买 uni-app 原生插件 登录 uni 原生插件市场,在 TencentCloud-TUICallKit 插件 详情页中购买(免费插件也可以在插件市场0元购)。购买后才能够云端打包使用插件。购买插件时请选择正确的 appid,以及绑定正确包名


2. 使用自定义基座打包 uni 原生插件 (请使用真机运行自定义基座) 使用 uni 原生插件必须先提交云端打包才能生效,购买插件后在应用的 manifest.json 页面的 App原生插件配置 项下单击选择云端插件,选择腾讯云原生音视频插件

直接云端打包后无法打 log,无法排查问题,需要自定义基座调试原生插件。
注意
自定义基座不是正式版,真正发布时,需要再打正式包。使用自定义基座是无法正常升级替换 APK。
请尽量不要使用本地插件,插件包超过自定义基座的限制,可能导致调试收费。

步骤3:引入原生插件

在 App.vue 文件注册原生插件。 使用 uni.requireNativePlugin 在 App.vue 注册原生插件,参数为腾讯云原生音视频插件ID: TencentCloud-TUICallKit
// 请按照 $TUICallKit 命名并且通过 uni.$TUICallKit 全局引入,修改命名会出现不生效的情况
uni.$TUICallKit = uni.requireNativePlugin('TencentCloud-TUICallKit');
console.log(uni.$TUICallKit, "TUICallKit | ok"); // 本地日志
说明
更多 TUICallKit API 详情可参考文档 TUICallKit-API

步骤4:本地调试和发布

使用自定义基座开发调试 TencentCloud-TUICallKit 插件 后,不可直接将自定义基座 APK 作为正式版发布。 需要重新提交云端打包(不能勾选“自定义基座”)生成正式版本。

步骤5:发起您的第一次通话

发起通话:



收到通话:




步骤6:离线推送

如果您需要集成离线推送,请参考 uni-app 离线推送集成 文档。 配置完成后,当单击接收到的音视频通话离线推送通知时, TUICallKit 会自动拉起音视频通话邀请界面

常见问题

如果您的接入和使用中遇到问题,请参见 常见问题

技术咨询

了解更多详情您可加入 腾讯云通信官方社群 进行咨询和反馈。