动态与公告

产品动态

产品近期公告

关于 TRTC Live 正式上线的公告

关于TRTC Conference 正式版上线的公告

Conference 商业化版本即将推出

关于多人音视频 Conference 开启内测公告

关于音视频通话 Call 正式版上线的公告

关于腾讯云音视频终端 SDK 播放升级及新增授权校验的公告

关于 TRTC 应用订阅套餐服务上线的相关说明

产品简介

产品概述

基本概念

产品功能

产品优势

应用场景

性能数据

购买指南

计费概述

免费时长说明

月订阅

现收现付

TRTC 逾期与暂停政策

常见问题解答

退款说明

新手指引

Demo 体验

视频通话 SDK

组件介绍

开通服务

跑通 Demo

快速接入

离线唤醒

会话聊天

云端录制

AI 降噪

界面定制

Chat 集成通话能力

更多特性

无 UI 集成

服务端 API

客户端 API

解决方案

错误码表

发布日志

常见问题

视频会议 SDK

组件介绍（TUIRoomKit）

开通服务（TUIRoomKit）

跑通 Demo（TUIRoomKit）

快速接入（TUIRoomKit）

屏幕共享（TUIRoomKit）

预定会议（TUIRoomKit）

会中呼叫（TUIRoomKit）

界面定制（TUIRoomKit）

虚拟背景（TUIRoomKit）

会议控制（TUIRoomKit）

云端录制（TUIRoomKit）

AI 降噪（TUIRoomKit）

会中聊天（TUIRoomKit）

机器人推流（TUIRoomKit）

更多特性（TUIRoomKit）

客户端 API（TUIRoomKit）

服务端 API（TUIRoomKit）

常见问题（TUIRoomKit）

错误码 (TUIRoomKit)

SDK更新日志（TUIRoomKit）

直播与语聊 SDK

Live 视频直播计费说明

组件介绍

开通服务（TUILiveKit）

跑通 Demo

无 UI 集成

UI 自定义

直播监播

视频直播

语聊房

高级功能

客户端 API

服务端 API

错误码

发布日志

常见问题

RTC Engine

开通服务

SDK 下载

API-Example

接入指引

API-参考手册

高级功能

AI 集成

概述

MCP 配置

Skills 配置

集成指南

常见问题

RTC RESTFUL API

History

Introduction

API Category

Room Management APIs

Stream mixing and relay APIs

On-cloud recording APIs

Data Monitoring APIs

Pull stream Relay Related interface

Web Record APIs

AI Service APIs

Cloud Slicing APIs

Cloud Moderation APIs

Making API Requests

Call Quality Monitoring APIs

Usage Statistics APIs

Data Types

Appendix

Error Codes

控制台指南

应用管理

套餐包管理

用量统计

监控仪表盘

开发辅助

解决方案

实时合唱

常见问题

迁移指南

计费相关

功能相关

UserSig 相关

应对防火墙限制相关

缩减安装包体积相关

Andriod 与 iOS 相关

Web 端相关

Flutter 相关

Electron 相关

TRTCCalling Web 相关

音视频质量相关

其他问题

旧版文档

RTC RoomEngine SDK（旧）

集成 TUIRoom (Web)

集成 TUIRoom (Android)

集成 TUIRoom (iOS)

集成 TUIRoom (Flutter)

集成 TUIRoom (Electron)

TUIRoom API 查询

实现云端录制与回放（旧）

监控仪表盘计费（旧）

协议与策略

安全合规认证

安全白皮书

信息安全说明

服务等级协议

苹果隐私策略：PrivacyInfo.xcprivacy

TRTC 政策

隐私协议

数据处理和安全协议

词汇表

Electron 相关

PDF

聚焦模式

字号

最后更新时间： 2024-06-07 11:20:49

安装相关
trtc-electron-sdk 是否兼容官方 Electron v12.0.1 版本?
兼容的，trtc-electron-sdk 没有特别依赖 elecron 自身的 SDK，所以没有相关的版本依赖。
下载 Electron 时出现 404 错误？
﻿
﻿
﻿
在终端中输入如下指令：
$ npm config set electron_custom_dir 8.1.1 # 根据版本号来决定
运行相关
Windows 32 系统运行报错 Error：resource\\trtc_electron_sdk.node is not a valid Win32 application， 提示需要 32 位的 trtc_electron_sdk.node?
﻿
﻿
﻿
解决方法：
1. 进入到工程目录下的 trtc-electron-sdk 库目录下（xxx/node_modules/trtc-electron-sdk）。 执行：
npm run install -- arch=ia32
2. 下载完 32 位的 trtc_electron_sdk.node 后，重新对项目进行打包。
vscode terminal 启动 Electron Demo，进入房间后白屏？
vscode 需有摄像头权限, 可采用如下方式进行权限添加。
    cd ~/Library/Application\\ Support/com.apple.TCC/
    cp TCC.db TCC.db.bak
    sqlite3 TCC.db    # sqlite> prompt appears.
﻿
    # for Mojave, Catalina
    INSERT into access VALUES('kTCCServiceCamera',"com.microsoft.VSCode",0,1,1,NULL,NULL,NULL,'UNUSED',NULL,0,1541440109);
﻿
    # for BigSur
    INSERT into access VALUES('kTCCServiceCamera',"com.microsoft.VSCode",0,1,1,1,NULL,NULL,NULL,'UNUSED',NULL,0,1541440109);
跑 Demo 抛出空指针未定义的错误：“cannot read property 'dlopen' of undefined”？
﻿
﻿
﻿
解决方法：
Electron 12 版本上下文隔离默认启用，可设置 contextIsolation 为 false。
let win = new BrowserWindow({
    width: 1366,
    height: 1024,
    minWidth: 800,
    minHeight: 600,
    webPreferences: {
    nodeIntegration: true,
    contextIsolation: false
        },
});
Electron 多次出现重新进房问题?
需要具体 case 进行分析，大致原因如下：
客户端网络状态不好（断网会触发重进房）。
连着发两次进房信令也会重进房的。
有可能是设备负载过高，导致解码失败的重进房。
同一个 UID 多端登录互踢导致的重进房。
终端出现提示“Electron failed to install correctly”？
当看似安装完成，运行项目时，终端上出现以下错误：
Error: Electron failed to install correctly, please delete node_modules/electron and try installing again
按照如下三个步骤进行手动下载：
1. 执行 npm config get cache 查看缓存目录。
2. 手动下载 Electron ，并放到缓存目录中。
3. 重新执行npm install。
调用摄像头或麦克风时直接崩溃？
使用 vscode 终端启动项目，当 trtc-electron-sdk 启动摄像头和麦克风时，程序直接崩溃：
解决方案 A：使用有授权的终端运行项目。
解决方案 B：给 vscode 授权：在 系统偏好设置 > 安全与隐私 中允许 vscode 的授权。
解决方案 C：按以下步骤关闭保护机制：
1.1 重启系统，按住 command + r 键，直到系统进入保护模式。
1.2 打开 terminal 输入 csrutil disable 禁用保护机制。
1.3 重启，正常进入系统，此时就可以使用 vscode 的终端启动项目了。
1.4 如需重新启动保护机制，只需要在第二步中执行csrutil enable。
Electron 在控制台中报错“xx is not defined”？
当运行项目时，Electron 在控制台中提示 xx is not defined，其中 xx 指代 node 模块。例如：
    Uncaught ReferenceError: require is not defined
在 Electron 的 main.js 文件中将  nodeIntegration 配置项改成 true：
    let win = new BrowserWindow({
        width: 1366,
        height: 1024,
        webPreferences: {
             nodeIntegration: true,  // 请将此项设置为 true
        },
      });
打包相关
.node 模块的加载问题?
报错信息
打包编译出的程序在运行时，在控制台中看到看到类似的报错信息：
NodeRTCCloud is not a constructor
﻿
﻿
﻿
Cannot open xxx/trtc_electron_sdk.node 或者 The specified module could not be found
﻿
﻿
﻿
dlopen(xxx/trtc_electron_sdk.node, 1): image not found
﻿
﻿
﻿
解决方法
出现类似上述的信息，说明 trtc_electron_sdk.node 模块没有被正确的打包到程序中，可按照以下步骤进行处理。
1. 安装 native-ext-loader。
  $ npm i native-ext-loader -D
2. 修改 webpack 配置。
2.1 使 webpack.config.js 在构建时可以接收名为 --target_platform 的命令行参数，以使代码构建过程按不同的目标平台特点正确打包，在 module.exports 之前添加以下代码：
const os = require('os');
// 如果不传 target_platform 参数，程序会默认按当前平台类型进行打包
const targetPlatform = (function(){
 let target = os.platform();
 for (let i=0; i<process.argv.length; i++) {
 if (process.argv[i].includes('--target_platform=')) {
     target = process.argv[i].replace('--target_platform=', '');
     break;
 }
 }
 // win32 统一表示 Windows 平台，包含 32 位和 64 位。darwin 表示 Mac 平台
 if (!['win32', 'darwin'].includes) target = os.platform();
 return target;
})();
2.2 添加以下 rules 配置：
module: {
 rules: [
 { 
     test: /\\.node$/, 
     loader: 'native-ext-loader', 
     options: { 
         rewritePath: targetPlatform === 'win32' ? './resources' : '../Resources' 
     } 
 },
 ]
}
注意：
使用 vue-cli 创建的项目，webpack 配置存放在 vue.config.js 文件中的 configureWebpack 选项中。
使用 create-react-app 创建的项目，webpack 配置文件为 [项目目录]/node_modules/react-scripts/config/webpack.config.js 。
3. 配置 packages.json 文件，添加打包配置和构建脚本。
3.1 添加 electron-builder 打包配置（注意大小写）：
"build": {
 "省略": "...",
 "win": {
 "extraFiles": [
     {
     "from": "node_modules/trtc-electron-sdk/build/Release/",
     "to": "./resources",
     "filter": ["**/*"]
     }
 ]
 },
 "mac": {
 "extraFiles": [
     { 
     "from": "node_modules/trtc-electron-sdk/build/Release/trtc_electron_sdk.node", 
     "to": "./Resources" 
     }
 ]
 },
 "directories": {
 "output": "./bin"
 }
},
3.2 添加 scripts 构建、打包脚本 create-react-app 项目请参考以下配置：
"scripts": {
 "build:mac": "react-scripts build --target_platform=darwin",
 "build:win": "react-scripts build --target_platform=win32",
 "compile:mac": "node_modules/.bin/electron-builder --mac",
 "compile:win64": "node_modules/.bin/electron-builder --win --x64",
 "pack:mac": "npm run build:mac && npm run compile:mac",
 "pack:win64": "npm run build:win && npm run compile:win64"
}
3.3 vue-cli 项目请参考以下配置：
"scripts": {
 "build:mac": "vue-cli-service build --target_platform=darwin",
 "build:win": "vue-cli-service build --target_platform=win32",
 "compile:mac": "node_modules/.bin/electron-builder --mac",
 "compile:win64": "node_modules/.bin/electron-builder --win --x64",
 "pack:mac": "npm run build:mac && npm run compile:mac",
 "pack:win64": "npm run build:win && npm run compile:win64"
}
找不到入口文件？
使用 create-react-app 创建的项目，使用 electron-builder 打包时可能会遇到此问题：
    $ node_modules\\.bin\\electron-builder.cmd
      • electron-builder  version=22.6.0 os=6.1.7601
      • loaded configuration  file=package.json ("build" field)
      • public/electron.js not found. Please see https://medium.com/@kitze/%EF%B8%8F-from-react-to-an-electron-app-ready-for-production-a0468ecb1da3
      • loaded parent configuration  preset=react-cra
其中 public/electron.js not found 指的就是无法找到入口文件。
解决方案
1. 移动并重命名入口文件：
$ cd [项目目录]
$ mv main.electron.js ./public/electron.js
2. 修改 pacakge.json 文件：
{
 "main": "public/electron.js",
 "省略": "..."
}
在执行打包时，出现 fs-extra 模块的语法错误？
[项目目录]\\node_modules\\electron-builder\\node_modules\\fs-extra\\lib\\empty\\index.js:33
    } catch {
            ^
﻿
SyntaxError: Unexpected token {
    at new Script (vm.js:51:7)
可以升级到最新的 node ，具体请参见 Node.js 官方网站。

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

实时音视频

Electron 相关

安装相关

trtc-electron-sdk 是否兼容官方 Electron v12.0.1 版本?

下载 Electron 时出现 404 错误？

运行相关

Windows 32 系统运行报错 `Error：resource\\trtc_electron_sdk.node is not a valid Win32 application`，提示需要 32 位的 trtc_electron_sdk.node?

vscode terminal 启动 Electron Demo，进入房间后白屏？

跑 Demo 抛出空指针未定义的错误：`“cannot read property 'dlopen' of undefined”`？

Electron 多次出现重新进房问题?

终端出现提示“Electron failed to install correctly”？

调用摄像头或麦克风时直接崩溃？

Electron 在控制台中报错“xx is not defined”？

打包相关

.node 模块的加载问题?

报错信息

解决方法

找不到入口文件？

解决方案

在执行打包时，出现 fs-extra 模块的语法错误？

帮助和支持

tencent cloud

实时音视频

Electron 相关

安装相关

trtc-electron-sdk 是否兼容官方 Electron v12.0.1 版本?

下载 Electron 时出现 404 错误？

运行相关

Windows 32 系统运行报错 Error：resource\\trtc_electron_sdk.node is not a valid Win32 application， 提示需要 32 位的 trtc_electron_sdk.node?

vscode terminal 启动 Electron Demo，进入房间后白屏？

跑 Demo 抛出空指针未定义的错误：“cannot read property 'dlopen' of undefined”？

Electron 多次出现重新进房问题?

终端出现提示“Electron failed to install correctly”？

调用摄像头或麦克风时直接崩溃？

Electron 在控制台中报错“xx is not defined”？

打包相关

.node 模块的加载问题?

报错信息

解决方法

找不到入口文件？

解决方案

在执行打包时，出现 fs-extra 模块的语法错误？

帮助和支持

Windows 32 系统运行报错 `Error：resource\\trtc_electron_sdk.node is not a valid Win32 application`，提示需要 32 位的 trtc_electron_sdk.node?

跑 Demo 抛出空指针未定义的错误：`“cannot read property 'dlopen' of undefined”`？