AI绘画有奖征文大赛:火热进行中> HOT
说明:
如果并没有解决您的问题,也欢迎您加入我们的 TUICallKit 技术交流 QQ 群: 605115878 来进行交流讨论。
我们团队即将在 Web 端丰富更多不同的组件,以满足您的开发需求。
希望您能抽出几分钟时间,为您自己的需求投上一票,我们将优先开发!
问卷地址:TUICallKit Web 问卷调查

一、基础环境问题

说明:
以下问题对于 TUICallKit 与 TUICallEngine SDK 同样适用。

TUICallEngine 和 TUICallKit 分别是什么?

TUICallKit 是含 UI 音视频通话组件,底层是用 TUICallEngine SDK,目前支持 Typescript+Vue2 / Typescript+Vue3,可直接将组件放到页面中,调用简单的接口即可直接实现音视频通话,开源地址为:TUICallKit/Web
TUICallEngine SDK 是音视频通话组件的无 UI SDK,如果 TUICallKit 的交互并不满足您的需求,您可以使用这套接口自己封装交互。npm 地址为 tuicall-engine-webrtc

Web 端支持哪些浏览器?报错“获取设备权限失败”?

请先确保页面已被授权使用麦克风或摄像头,参见 设备授权说明
对浏览器的详细支持度,请参见 浏览器兼容信息
对于上述没有列出的环境,您可以在需要检测的浏览器打开 能力测试 测试是否完整的支持 WebRTC 的功能。

为什么本地开发测试能正常使用,但是部署到线上用 IP 访问后无法正常视频/语音通话?

对网站域名协议的要求
出于对用户安全、隐私等问题的考虑,浏览器限制网页在 HTTPS 协议下才能正常使用本文档中所对接组件的全部功能。为确保生产环境中的用户能够顺畅体验产品功能,请将您的网站部署在 https:// 协议的域名下。更多请参见 页面访问协议说明
对网络环境的要求
在使用 TUICallKit 时,用户可能因防火墙限制导致无法正常进行音视频通话,请参考 应对防火墙策略 将相应端口及域名添加至防火墙白名单中。

在接通过程中报:"is not included in the current tim's package"?

TUICallKit(含 TUICallEngine SDK)依赖的 tim-js-sdk 版本需要 >= 2.21.2。
如果 tim-js-sdk 依赖包版本正确,则可能是 SDKAppID 未购买音视频套餐或套餐包不支持所调用的功能,请访问 音视频通话功能出现了未开通的错误提示

TUICallKit(含 TUICallEngine)是否支持接收离线消息?

不支持接收离线消息。
支持离线消息推送,可以通过 call / groupCall 中的 offlinePushInfo 添加需要推送的消息。

TUICallEngine init 未完成,需要在 init 完成后使用此API

未调用 login 接口,所有功能需要先进行登录完成后才能使用,具体参考 TUICallEngine login
注意:
TUICallEngine login 是一个异步接口,避免在 login 还未完成,直接调用 TUICallEngine 的接口。

当前通话状态无法使用该 API

API 与通话状态对照表:
API
idle
calling
connected
call
×
×
groupCall
×
×
accept
×
×
reject
×
×
hangup
×
inviteUser
×
joinInGroupCall
×
×

二、TUICallKit 问题(含 UI)

TUICallKit Web 支持什么框架?支持 H5 吗?

TUICallKit 适用于 Vue2.7 + Typescript 或者 Vue3 + Typescript 项目,若您采用其他语言或者技术栈,请访问 界面定制指引
TUICallKit 支持 H5,通过页面 UA 自动修改适应移动端的布局,为了移动端的良好体验,推荐通过修改 CSS 在 H5 时将 <TUICallKit/> 组件放大至全屏。

TUICallKit 打包失败?

对于 Vite 项目,您需要在 vite.config.js 中添加 base: "./"
对于 Vue-CLI 创建的 webpack 项目,您需要在 vue.config.js 中添加 publicPath: "./"

TUICallKit 报错“获取设备权限失败”?

请先确保页面已被授权使用麦克风或摄像头,参见 设备授权说明
可以尝试 官方 Demo 是否可以正常通话,然后在设备检测页面 检查是否支持 webrtc。如果还有问题,请联系我们 QQ群:646165204。

timeout 字段设置无效原因?

该字段目前在 call / groupcall API 中会被使用到。
目前全平台 TUICallKit 的策略是被叫登录后,仅拉取 30s 内的历史消息。所以被叫登录后无法拉到主叫 30s 前的呼叫信息,从而导致被叫无法拉起邀请页面进行通话。