常见问题

环境相关问题

TUIRoomKit Web 支持的平台有哪些?

TUIRoomEngine Web 支持的平台请参考:TRTC Web SDK 对浏览器的支持情况
对于上述没有列出的环境,您可以在当前浏览器打开 TRTC 能力测试 测试是否完整的支持 WebRTC 的功能。

为什么本地开发测试能正常使用 TUIRoomKit, 但是部署到线上无法使用?

出于对用户安全、隐私等问题的考虑,浏览器限制网页只有在安全的环境下(例如 httpslocalhostfile:// 等协议),才能采集麦克风、摄像头。HTTP 协议是不安全的,浏览器会禁止在 HTTP 协议下采集媒体设备。
若您在本地开发测试一切正常,但是页面部署后,却无法正常采集摄像头、麦克风。则请检查您的网页是否部署到了 HTTP 协议上,若是,请使用 HTTPS 部署您的网页,并确保具备合格的 HTTPS 安全证书。
更多详情请参见 URL域名及协议限制说明

TUIRoomKit Web 端是否支持使用 iframe 集成?

支持的。在 iframe 中集成 TUIRoom Web 需要给 iframe 标签增加属性来开启相关权限,具体参考如下。
// 开启麦克风、摄像头、屏幕分享、全屏权限
<iframe allow="microphone; camera; display-capture; display; fullscreen;">

编译相关问题

Webpack 5 引入 TUIRoomEngine sdk 报错:webpack < 5 used to include polyfills for node.js core modules by default. This is no longer the case. Verify if you need this module and configure a polyfill for it.

报错原因是由于在 webpack5 中移除了 nodejs 核心模块的 polyfill 自动引入,你可在 vue.config.js 中添加 configureWebpack 配置解决该问题。
module.exports = defineConfig({
// ...
configureWebpack: (config) => {
config.resolve.fallback = {
...config.resolve.fallback,
url: false,
path: false,
fs: false,
crypto: false,
};
}
});

功能相关问题

项目中可以同时引入 tim-js-sdk 和 @tencentcloud/tuiroom-engine-js 吗?

可以的。你可以通过 tim-js-sdk 中的 TIM 创建 tim 实例对象,在 TUIRoomEngine 初始化时传入 init 接口。
await TUIRoomEngine.init({
sdkAppId: 0, // 填写您申请的 sdkAppId
userId: '', // 填写您业务对应的 userId
userSig: '', // 填写服务器或本地计算的 userSig
tim, // 传入 tim 实例
});
同时,你也可以通过 roomEngine.getTIM 方法获取 TUIRoomEngine 内部使用的 tim 实例。