咨询类

• 如何匿名登录
• 如何配置构建环境
• Windows 如何自定义配置安装包

故障类

• Windows 端启动项目后，摄像头画面黑屏
• 本地启动项目后，创建或加入课堂失败，应如何处理
• 本地启动项目，启动后发现环境配置仍为Web端
• 安装Electron失败

咨询类

如何匿名登录？

本项目支持用户鉴权后加入房间，鉴权信息填写错误将无法加入房间、不填写鉴权信息为匿名加入房间，开发者可根据自己需要自行调整。

详细信息可参考项目测试环境启动后的加入页面。

如何配置构建环境？

不同环境的包需要在对应环境上进行构建，dmg 的包需要在 macOS 上构建，exe 的包需要在 windows 上构建，无法进行跨端打包。

Windows 如何自定义配置安装包？

请参考 electron-builder nsis 文档进行自定义配置。

故障类

Windows 端启动项目后，摄像头画面黑屏

问题现象：

Windows 端摄像头画面黑屏。

问题原因：

Windows 端摄像头设备被其他应用占用时，智慧云课堂应用中摄像头画面会显示黑屏。

解决方案：

请确认摄像头是否已被其他应用占用。如果确认占用，关闭其他应用后重试。

本地启动项目后，创建或加入课堂失败

问题现象：

创建或加入课堂失败，并报错 “请求失败 TypeError：Fialed to excute 'setRequestHeader' on XMLHttpRequest”。

问题原因：

未配置项目的 .env 文件。启动了项目，导致产生文件缓存，需清除缓存重新启动。

解决方案： 您可以参考以下方案处理：

• 方案 1：配置.env文件后，删除 node_modules 并清理 npm 缓存、重新安装依赖。

• 方案 2：直接手动删除 node_modules 下的 .cache 文件夹。

# 配置.env文件
rm -rf node_modules
npm cache clean -f
npm install
# or
rm -rf node_modules/.cache

本地启动项目，启动后发现环境配置仍为 Web 端

问题现象：

启动后发现环境配置仍为 Web 端。

问题原因：

未配置项目的 .env 文件。启动了项目，导致产生文件缓存，需清除缓存重新启动。

解决方案：

您可以参考以下方案处理：

• 方案 1：配置.env文件后，删除 node_modules 并清理 npm 缓存、重新安装依赖。
• 方案 2：直接手动删除 node_modules 下的 .cache 文件夹。

安装 Electron失败

问题现象：

安装 Electron 失败、超时，提示信息类似如下：

解决方案：

在项目的根目录下增加.npmrc 文件，配置 Electron 地址为淘宝镜像源。

.npmrc 文件的内容如下：

ELECTRON_MIRROR=https://npm.taobao.org/mirrors/electron/