rdp-cli
設定 RDP 聲音與麥克風：留在本機或遠端
分別設定 rdp-cli 的 RDP 播放去向與麥克風來源，理解 client、host、off，並確認遠端應用程式實際收到的聲音。
兩個選擇，兩個方向
client 是開啟 rdp-cli 檢視器的電腦，host 是被控制的 Windows 電腦。瀏覽器若在另一台電腦開啟，client 就使用該電腦的裝置。播放選項決定遠端應用程式的聲音在哪裡聽；麥克風選項決定哪一端供應錄音。兩者預設都是 client。
| --audio-mode · 播放 | --microphone-mode · 麥克風 | |
|---|---|---|
| client | 在檢視器中聽聲音 | 使用明確啟用的檢視端麥克風 |
| host | 使用被控電腦的預設喇叭 | 使用被控電腦的預設麥克風 |
| off | 關閉工作階段播放 | 關閉麥克風輸入 |
為 host 模式準備被控電腦
任一選項使用 host 前，先在被控 Windows 上以對應版本的 rdp-cli.exe 執行以下命令。Windows 會要求管理員確認，從同一 EXE 安裝 rdp-cli 主機音訊服務。遠端播放及遠端麥克風都需要此服務；相容命令名稱仍為 host-microphone。
.\rdp-cli.exe host-microphone install
.\rdp-cli.exe host-microphone status
建立連線時選擇方向
先依快速上手連線一次，加上 --save-credential RDP_ACCOUNT 儲存認證，名稱可自行選擇。以下示例重用該認證，請替換主機、帳號與名稱。兩個組合擇一，不要同時執行。client/host 是本機播放、遠端麥克風；host/client 則相反。任一值可改為 off。變更方向需要新的 connect；reconnect 或檢視器靜音不會改變方向。
Windows PowerShell: rdp-cli → .\rdp-cli.exe.
rdp-cli connect --host 192.0.2.20 --user USER --credential-ref RDP_ACCOUNT --audio-mode client --microphone-mode host
rdp-cli connect --host 192.0.2.20 --user USER --credential-ref RDP_ACCOUNT --audio-mode host --microphone-mode client
確認實際結果，再停止擷取
將 data.session 儲存為 SESSION，開啟檢視器聆聽。使用 client 麥克風時，先接手再明確開啟麥克風，並確認系統或瀏覽器權限。在遠端應用程式選擇錄音裝置並開始錄音。選擇方向不會自行開始錄音。請核對實際聲音及錄音檔案，不只看連線狀態。
rdp-cli status --session SESSION
rdp-cli audio status --session SESSION
rdp-cli watch --session SESSION --viewer window
無聲時查看 audio status 及 status 中的方向。HOST_PLAYBACK_DEVICE_UNAVAILABLE、HOST_MICROPHONE_DEVICE_UNAVAILABLE 表示實體裝置不可用；橋接等待錯誤需檢查主機服務。HOST_MICROPHONE_RDP_CAPTURE_UNAVAILABLE 表示系統版本或原則未提供所需 RDP 錄音通道，Windows 7 Professional 並非支援所有組合。完成後明確停止擷取；重連不會自動重啟。這些選項用於 RDP，VNC 與原生 X11 沒有相同音訊通路。
rdp-cli audio microphone --session SESSION --action stop