权限与隐私

Beam 只通过选定来源所需的操作系统路径请求受保护的能力。交互录制是可选的，不会存储输入文字。

Windows

• 屏幕和窗口捕获使用 Windows Graphics Capture。
• 光标和点击能力取决于 Windows 捕获路径提供的内容。
• 交互访问不需要 Linux Polkit helper。

macOS

能力	要求
屏幕、窗口或应用捕获	ScreenCaptureKit 和屏幕录制权限。
交互访问	CoreGraphics 辅助功能权限。
直接 MP4 捕获	macOS 15 或更高版本。
Chromium 系统音频	macOS 13 或更高版本；从 macOS 14.2 起需要 NSAudioCaptureUsageDescription。
麦克风和摄像头	对应的 macOS 隐私权限。

Linux

键盘快捷键和鼠标点击的可用性可能因可访问的输入设备而不同。Linux 交互捕获始终报告不会录制输入文字。

要求	用途或限制
XDG Desktop Portal v2 或更高版本	显示系统来源选择器并取得录制同意。
PipeWire	传输选定的屏幕和原生系统音频流。
FFmpeg 加兼容的 MP4 编码器	编码捕获的会话。
Beam 输入 helper	提供可选的键盘快捷键和鼠标点击元数据。
Polkit / pkexec 和 broker	可能需要授权和运行输入 helper。
单一 portal 来源	每个会话选择一个屏幕或窗口；区域捕获不可用。

全屏捕获中的 Beam 窗口

Beam 无法在 Linux 全屏捕获中隐藏自己的窗口。仍建议使用屏幕模式；确认 portal 选择前先安排好 Beam。

交互隐私

• 交互捕获是可选的。
• 它只在录制会话处于活动状态时运行。
• 它存储受支持的点击元数据和安全快捷键标记。
• 它绝不存储用户输入的文字。

媒体隔离和失败边界

在受支持的情况下，摄像头、麦克风和系统音频会存储为独立轨道或附属媒体。在 Linux 之外，系统音频使用 Chromium display-media 捕获。Electron 只向受信任的应用渲染器授予媒体访问权限。准备期间报告不可用的摄像头可以被省略而继续捕获；其他摄像头或附属媒体错误，以及选定麦克风或系统音频来源失败，都可能停止录制启动。

详细设置

操作系统设置和排查方法请使用平台支持参考。