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），在 App 第一次要求音訊時跳出提示。其他發行版則完全依賴 ALSA／PulseAudio 的裝置權限，完全沒有個別 App 的提示：只要裝置未靜音且已選取，包括 Pluely 在內的任何 App 都能使用。如果不確定你的系統用的是哪一種，最保險的第一步永遠是上述的聲音設定面板。

缺少或設定錯誤時的症狀：聆聽模式中你的聲音沒有任何波形變化，也從不轉錄你這一方的對話；按住說話時沒有任何反應。

螢幕擷取與 portal 權限（特別是在 Wayland 上）

提問模式中的截圖取決於你的顯示伺服器：

  • X11 工作階段讓 Pluely 可以直接讀取螢幕。選取區域時，每個螢幕上都會顯示 Pluely 自己的選取浮動層。
  • Wayland 工作階段從不讓 App 直接讀取螢幕，所以 Pluely 會透過 xdg-desktop-portal（搭配桌面環境的後端，例如 GNOME 或 KDE portal）要求權限。第一次拍全螢幕截圖時會出現權限對話框，桌面環境會記住你的選擇。選取區域時，會開啟桌面環境自己的截圖選擇器（區域、視窗或螢幕），而不是 Pluely 的浮動層，結果同樣會出現在對話中。關閉選擇器就等於取消。

通話另一方的系統音訊不會經過 portal。Pluely 會透過 PulseAudio 或 PipeWire 錄製輸出裝置的監聽來源（monitor source），麥克風也透過同一個音訊伺服器錄製，所以它會和你的會議 App 共用麥克風，而不是跟它搶裝置。

在 Linux 上無法讓 Pluely 從螢幕分享中隱藏。X11 和 Wayland 都沒有提供讓視窗把自己排除在擷取之外的方法，所以在 Linux 上，浮動視窗會出現在分享的螢幕和錄影中。請把它移出分享的螢幕，或改為只分享單一視窗而不是整個螢幕。

如何檢查／重設 portal 權限：細節因桌面環境而異，但大致做法如下：

  1. 確認已安裝 xdg-desktop-portal（以及桌面環境專用的後端，例如 xdg-desktop-portal-gnome 或 xdg-desktop-portal-kde）。大多數現代發行版都會預設安裝，但最小化安裝時可能會缺少。
  2. 在桌面環境的隱私權設定中，尋找螢幕分享或遠端桌面的權限設定；先前拒絕某個 App 的權限，有時可以在那裡重設。
  3. 如果 portal 提示是被關閉而不是被回應，請在 Pluely 中再擷取一次，重新觸發提示。

缺少時的症狀：截圖失敗、拍出空白圖片，或嘗試附加螢幕截圖時什麼都沒發生；在聆聽模式中，只有你自己的麥克風被轉錄，通話另一方的聲音一直沒有出現。

Wayland 上的鍵盤快速鍵

Wayland 上的全域快速鍵會經過桌面環境的 GlobalShortcuts portal，需要 KDE Plasma 5.27 或以上、GNOME 48 或以上，或已安裝其 portal 的 wlroots 桌面環境（Hyprland、Sway）。桌面環境可能會請你確認一次 Pluely 的快速鍵，你也可以在那裡更改按鍵。儀表板中的游標與快速鍵頁面會告訴你綁定是否成功。在 X11 工作階段中，快速鍵不需要任何 portal 就能運作。

另外還有兩項 Wayland 的限制，來自合成器而不是 Pluely：移動浮動視窗的快速鍵和儲存的浮動視窗位置都不會有作用，因為 Wayland App 無法自行定位視窗；而且 GNOME 會忽略「永遠在最上層」。請改為直接把浮動視窗拖到你想要的位置。

不確定時，先檢查輸入裝置

由於 Linux 的設定差異非常大，最快的診斷方法幾乎都是先在音訊伺服器層確認麥克風已選取、未靜音且有輸入訊號。這樣就能分辨問題出在音訊設定，還是螢幕擷取／portal 權限，兩者需要不同的解決方法。

相關內容

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