未检测到相机

你看到的情况

你打开 Camera 面板。Device 下拉菜单显示 No camera，或只显示其他相机（内置摄像头等），缺少工作区相机。

发生了什么

Beam Bench 会向操作系统请求可用的视频设备。发布版本仅列出系统中的真实相机。如果相机未出现，请刷新列表，并确认操作系统能够看到它。

解决方法

Linux 相机采集

如果列表中有相机但无法采集，请先更新到 0.2.32 或更新版本。受影响的 AppImage 即使已安装插件，也可能记录 GStreamer element appsink not found。如果仍然失败，请在操作系统中检查相机，并检查以下运行时软件包。

从0.2.32起，Linux AppImage会在更新自动重启后恢复相机和字体环境，无需再手动退出并重新打开。尚未测试实体相机采集。

Linux 相机采集需要发行版提供的 GStreamer base 和 good 插件。在 Ubuntu 或 Linux Mint 中安装后，重新启动 Beam Bench：

sudo apt install gstreamer1.0-plugins-base gstreamer1.0-plugins-good

如果相机未连接或未通电

确认 USB 连接和电源，然后在 Camera 面板中点击 Rescan Cameras。

如果 macOS 拒绝了权限

Beam Bench 第一次捕获画面时，macOS 会请求权限。如果你错过或拒绝了提示：

1. 系统设置 → 隐私与安全性 → 摄像头。
2. 找到 Beam Bench。
3. 启用它。
4. 重新启动应用。

选择相机并点击 Capture New Image，以触发首次权限请求。

如果相机正被其他应用使用

某些相机驱动或操作系统配置一次只允许一个应用访问相机。关闭 Zoom、FaceTime 和其他捕获工具，然后点击 Rescan Cameras。

如果操作系统完全看不到相机

使用系统相机应用进行验证：

• macOS：打开 Photo Booth 或 Camera 应用。如果相机在那里也没有出现，问题出在操作系统层面（驱动、连接线或硬件）。
• Windows：打开 Camera 应用。
• Linux：v4l2-ctl --list-devices 会列出视频设备。

如果操作系统看不到相机，问题出在相机、连接线或驱动上，而不是 Beam Bench。

如果计算机没有活动配置

没有活动机器配置文件时，Device 下拉菜单会被禁用。Camera 面板会显示：选择或创建活动机器配置文件以选择相机。 请在 Device Settings 中设置机器配置文件。

验证是否已解决

• Device 下拉菜单列出你的相机。
• 选择相机后，Capture New Image 可以捕获画面。

仍然无法解决？

• Camera 面板参考。
• 安装相机指南。
• 在 Facebook 群组中发帖，并附上相机型号和操作系统信息。