腾讯云视立方Electron 相关问题

安装相关

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

兼容的,trtc-electron-sdk 没有特别依赖 elecron 自身的 SDK,所以没有相关的版本依赖。

Electron 下载慢甚至卡住不动?

当开始下载tmp-3320-1-SHASUMS256.txt-6.1.9文件或其它文件时,可能会特别慢,甚至在辛苦等待了很长时间后,等到的却是 npm 的 Timeout 错误:

复制代码

Downloading tmp-3320-1-SHASUMS256.txt-6.1.9

[=> ] 1.0% of 5.56 kB (0 B/s)

**解决方案 A:**如果您是在家中办公,可以切换到国内的 npm 镜像。

复制代码

指定 npm 国内镜像

$ npm config set registry=https://registry.npm.taobao.org/

指定 Electron 的国内镜像地址

$ npm config set ELECTRON_MIRROR=https://npm.taobao.org/mirrors/electron/

$ npm install

解决方案 B: 如果您是在公司办公,那么您公司的网络管理员可能已经设置了代理,需要确认 npm 的 proxy 配置是否指向了公司的代理服务器,以及是否配置了环境变量ELECTRON_GET_USE_PROXY,如均无配置,请按以下步骤执行。

1.1 设置 npm 代理 :npm config set all_proxy=[您的代理地址]

1.2 配置ELECTRON_GET_USE_PROXY环境变量,这样 Electron 的安装脚本就会通过 npm 的代理下载。

**解决方案 C:**如果您是 Mac 环境。

复制代码

$ export ELECTRON_GET_USE_PROXY=true

**解决方案 D:**如果您是 Windows 环境。

1.1 右键单击计算机 > 属性 > 高级系统设置 > 环境变量

1.2 按下图操作设置环境变量 ELECTRON_GET_USE_PROXY ,然后执行npm installnpm install --proxy=[您的代理地址]

下载 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

  1. 下载完 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

},

});

Mac 下,打包安装后,运行时白屏、崩溃问题

在 Mac OS 10.4 及以后版本,运行安装包时,如果获取不到 摄像头、麦克风、屏幕录制 权限,程序会因为没有这些硬件的访问权限,在进入 TRTC 房间后直接白屏或者崩溃。解决方法如下:

  1. 添加 entitlements.mac.plist 文件,文件内容如下,相关配置的具体含义,请参见 苹果开发者网站
复制代码

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">

<plist version="1.0">

<dict>

<key>com.apple.security.cs.allow-unsigned-executable-memory</key>

<true></true>

<key>com.apple.security.cs.allow-jit</key>

<true></true>

<key>com.apple.security.cs.allow-dyld-environment-variables</key>

<true></true>

<key>com.apple.security.device.audio-input</key>

<true></true>

<key>com.apple.security.device.camera</key>

<true></true>

</dict>

</plist>

  1. 使用 electron-builder 打包时,需要将 entitlements.mac.plist 文件路径配置到 electron-builder 打包配置中。参考代码如下,注意"entitlements""entitlementsInherit" 两个配置项,"hardenedRuntime"需要配置为 true,配置项含义请参见 electron-builder官网
复制代码

{

"build": {

"mac": {

"extraFiles": [

{

"from": "node_modules/trtc-electron-sdk/build/Release/trtc_electron_sdk.node",

"to": "./Resources"

}

],

"type": "distribution",

"hardenedRuntime": true,

"entitlements": "assets/entitlements.mac.plist",

"entitlementsInherit": "assets/entitlements.mac.plist",

"gatekeeperAssess": false,

"target": [

"dmg"

]

},

}

}

  1. Mac OS 12.1 及以上版本,仅使用以上配置,已不足以申请 麦克风、摄像头权限,需要借助 Electron API 的 systemPreferences.askForMediaAccess() 接口,在主进程中,主动申请一次摄像头、麦克风权限。参考代码如下。systemPreferences.getMediaAccessStatus() 接口可以检测 麦克风、摄像头、屏幕录制权限,但 systemPreferences.askForMediaAccess() 接口只能申请 摄像头 和 麦克风权限。
复制代码

async checkAndApplyDeviceAccessPrivilege() {

const cameraPrivilege = systemPreferences.getMediaAccessStatus('camera');

console.log(

`checkAndApplyDeviceAccessPrivilege before apply cameraPrivilege: ${cameraPrivilege}`

);

if (cameraPrivilege !== 'granted') {

await systemPreferences.askForMediaAccess('camera');

}

const micPrivilege = systemPreferences.getMediaAccessStatus('microphone');

console.log(

`checkAndApplyDeviceAccessPrivilege before apply micPrivilege: ${micPrivilege}`

);

if (micPrivilege !== 'granted') {

await systemPreferences.askForMediaAccess('microphone');

}

const screenPrivilege = systemPreferences.getMediaAccessStatus('screen');

console.log(

`checkAndApplyDeviceAccessPrivilege before apply screenPrivilege: ${screenPrivilege}`

);

}

  1. 更多崩溃问题处理方法,请参阅 Electron 应用崩溃问题排查与解决方法

打包相关

.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

  1. 修改 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

  1. 配置 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/️-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

  1. 修改 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 官方网站

Mac 下如何构建 X64 和 ARM64 双架构包?

TRTC Electron SDK 从 10.6.403 版本开始,默认支持 Mac 下构建 X64 和 ARM64 双架构包,只需要修改一下 electron-builder 和构建工具 Webpack 或者 Vite 配置即可。详细配置请参见 TRTC Electron SDK: Mac 下构建双架构包

支持双架构打包后,如果不修改配置,则默认构建单架构应用包,架构类型与构建机器 CPU 类型相同。

说明:

更多 Electron 相关问题请关注 Electron 常见问题收录Electron 常见问题收录II,我们将持续更新。

相关推荐
Fre丸子_5 小时前
ffmpeg之播放一个yuv视频
ffmpeg·音视频
9527华安5 小时前
FPGA多路MIPI转FPD-Link视频缩放拼接显示,基于IMX327+FPD953架构,提供2套工程源码和技术支持
fpga开发·架构·音视频
catmes6 小时前
设置浏览器声音或视频的自动播放策略
chrome·音视频·edge浏览器
杨德杰8 小时前
QT多媒体开发(一):概述
qt·音视频·多媒体
是十一月末9 小时前
Opencv实现图片和视频的加噪、平滑处理
人工智能·python·opencv·计算机视觉·音视频
余~~1853816280011 小时前
稳定的碰一碰发视频、碰一碰矩阵源码技术开发,支持OEM
开发语言·人工智能·python·音视频
m0_7482323911 小时前
WebRTC学习二:WebRTC音视频数据采集
学习·音视频·webrtc
Kai HVZ13 小时前
python爬虫----爬取视频实战
爬虫·python·音视频
强哥之神14 小时前
Nexa AI发布OmniAudio-2.6B:一款快速的音频语言模型,专为边缘部署设计
人工智能·深度学习·机器学习·语言模型·自然语言处理·音视频·openai
EasyDSS15 小时前
国标GB28181-2022平台EasyGBS:安防监控中P2P的穿透方法
网络协议·php·音视频·p2p