PluelyPluely文档

快速入门

Pluely 的 Linux 权限：麦克风与屏幕捕获设置

Linux 不像 macOS 和 Windows 那样有一套统一的权限系统。你需要检查什么，取决于你的音频服务器（PipeWire 或 PulseAudio）和显示服务器（X11 或 Wayland），而这两者又取决于你的发行版和桌面环境。本页介绍 Pluely v1 需要的两样东西，即麦克风输入和屏幕捕获，以及如何在典型的现代 Linux 环境中逐一验证。

在 Pluely 中，仪表板 → 权限和音频会把这些项目显示为由系统管理，并提供打开 Linux 设置按钮，同时实时检查系统音频。

通过 PipeWire 或 PulseAudio 使用麦克风

目前大多数 Linux 发行版通过 PipeWire（通常带有 PulseAudio 兼容层）或单纯的 PulseAudio 传输音频。Pluely v1 需要在这一层选中一个能正常工作的输入设备，才能在聆听模式下听到你的声音，并支持按键说话。

检查输入设备是否存在并已选中：

  • 打开桌面环境的声音设置（具体路径因环境而异，例如 GNOME 的设置 → 声音，或 KDE 的系统设置 → 音频），确认已将正确的麦克风选为输入设备，并且说话时输入电平会跳动。

  • 你也可以在终端中直接列出音频源。在 PipeWire 或 PulseAudio 系统上运行：

    pactl list short sources

    在列表中找到你的麦克风，并确保它没有被静音。

权限模型因发行版/桌面环境而异：有些发行版使用 PipeWire 的会话/portal 权限按应用控制麦克风访问（思路与 macOS 类似），在应用首次请求音频时弹出提示。另一些则完全依赖 ALSA/PulseAudio 的设备权限，根本没有按应用的提示：只要设备未静音且已选中，包括 Pluely 在内的任何应用都可以使用它。如果你不确定自己的系统使用哪种模型，最稳妥的第一步始终是上面提到的声音设置面板。

缺少或配置错误时的表现：聆听模式中你说话时波形没有任何变化，你这一方的对话始终不会被转录；按住按键说话也没有任何反应。

屏幕捕获与 portal 权限（尤其是 Wayland）

提问模式下的截屏取决于你的显示服务器：

  • X11 会话允许 Pluely 直接读取屏幕。区域选择会在每台显示器上显示 Pluely 自己的选区遮罩。
  • Wayland 会话从不允许应用直接读取屏幕，因此 Pluely 会请求 xdg-desktop-portal（配合桌面环境的后端，例如 GNOME 或 KDE 的 portal）。第一次截取全屏时会弹出权限对话框，桌面环境会记住你的选择。区域选择会打开桌面环境自带的截图选择器（区域、窗口或屏幕），而不是 Pluely 的遮罩，结果同样会进入聊天中。关闭选择器即表示取消。

通话中对方的系统音频不经过 portal。Pluely 通过 PulseAudio 或 PipeWire 录制输出设备的 monitor 源，麦克风也通过同一个声音服务器录制，因此它会与会议应用共享麦克风，而不会与之争抢设备。

在 Linux 上无法让 Pluely 在屏幕共享中隐藏。X11 和 Wayland 都没有提供让窗口将自身排除在捕获之外的方法，因此在 Linux 上，悬浮窗在共享的屏幕和录屏中都是可见的。请把它移到不共享的屏幕上，或者只共享单个窗口而不是整个屏幕。

如何检查/重置 portal 权限：具体细节因桌面环境而异，但大致方法如下：

  1. 确认已安装 xdg-desktop-portal（以及对应桌面的后端，例如 xdg-desktop-portal-gnome 或 xdg-desktop-portal-kde）。大多数现代发行版默认自带，但在最小化安装中可能缺失。
  2. 在桌面环境的隐私设置中查找屏幕共享或远程桌面权限设置，有时可以在那里重置之前拒绝过的应用权限。
  3. 如果 portal 提示是被直接关掉而不是作出了选择，请在 Pluely 中再次尝试截取，重新触发提示。

缺少时的表现：截屏失败、得到空白图像，或者尝试附加截屏时毫无反应；在聆听模式下，只有你自己的麦克风被转录，通话中对方的声音始终不会出现。

Wayland 上的键盘快捷键

在 Wayland 上，全局快捷键通过桌面环境的 GlobalShortcuts portal 实现，这需要 KDE Plasma 5.27 或更高版本、GNOME 48 或更高版本，或者已安装对应 portal 的 wlroots 桌面（Hyprland、Sway）。桌面环境可能会请你确认一次 Pluely 的快捷键，你也可以在那里更改按键。仪表板中的光标和快捷键页面会告诉你绑定是否成功。在 X11 会话中，快捷键无需任何 portal 即可使用。

另外还有两项 Wayland 限制，由合成器而非 Pluely 决定：移动悬浮窗的快捷键和已保存的悬浮窗位置不会生效，因为 Wayland 应用无法自行定位窗口；GNOME 也会忽略始终置顶。请直接把悬浮窗拖到你想要的位置。

拿不准时，先检查输入设备

由于 Linux 配置千差万别，最快的诊断方法几乎总是先在音频服务器层面确认：麦克风已选中、未静音并且有输入信号。这样就能分清问题出在音频配置上，还是出在屏幕捕获/portal 权限上，两者的解决方法并不相同。

相关内容

最后更新：2026年7月10日 · pluely.com