系統
隨附於 Macro Deck從面板控制電腦:應用程式、音量、命令、通知、睡眠和關機。
系統整合頁面,開關已開啟,且沒有設定選項
- 啟動、聚焦或關閉應用程式、檔案、資料夾和網站
- 預設或任何音訊裝置的音量和靜音
- 執行命令並將輸出儲存到變數
- 鎖定、睡眠、休眠、重新啟動或關機
- 以變數提供 CPU、RAM、GPU、磁碟、時間和目前焦點的應用程式
系統整合會控制執行 Macro Deck 的電腦。它隨 Macro Deck 一同提供,預設已啟用,在 Windows、macOS 和 Linux 上都不需要任何設定。
可以做什麼
- 應用程式、檔案和網站: 啟動應用程式 會啟動應用程式,其 模式 也可以將執行中的應用程式移到最前方(啟動或聚焦),或在第二次按下時關閉它(啟動/停止切換)。開啟檔案、開啟資料夾 和 開啟網站 會以預設應用程式開啟。強制結束應用程式 會依名稱結束處理程序。
- 音訊: 提高音量、降低音量、設定音量 和 靜音/取消靜音 適用於預設輸出、預設輸入或特定裝置。使用 靜音/取消靜音 的按鈕會顯示裝置是否已靜音。
- 命令: 執行命令 會在預設 Shell、PowerShell 或 Bash 中執行命令列,並可將輸出內容儲存到變數。
- 通知: 傳送通知 會顯示作業系統的通知。顯示 Macro Deck 通知 會在所有已連線的螢幕上,於 Macro Deck 中顯示訊息。
- 電源: 鎖定電腦、睡眠、休眠、重新啟動 和 關機。
變數
此整合會以變數回報電腦的狀態:CPU、RAM 和 GPU 使用率,每個磁碟的大小、可用空間和活動,每個喇叭和麥克風的音量和靜音狀態,日期和時間,電腦名稱和作業系統,螢幕是否已鎖定,以及位於最前方的應用程式。可以在標籤中顯示,用 歷史圖表 或 儀表 小工具繪製圖表,或在自動化中對其做出反應。
設定範例
- 耳機麥克風的麥克風按鈕,使用 靜音/取消靜音 並顯示是否已靜音。
- 繫結到
system_volume_percent的滑桿,用來設定喇叭音量。 - 包含
system_cpu_usage_percent、system_ram_usage_percent和system_gpu_0_usage_percent的 儀表 小工具。 - 一個按鈕使用 啟動或聚焦 模式的 啟動應用程式 開啟音樂播放器。
- 「晚安」按鈕執行 鎖定電腦,或在 等待 後執行 關機。
- 一個流程使用 執行命令 執行指令碼,並將結果寫入顯示在按鈕上的變數。
新的音訊裝置和磁碟在插入後幾秒內就會有自己的變數。
需要準備
- 在 Windows、macOS 或 Linux 上執行的 Macro Deck 3
- 在 Linux 上:音量需要 pactl 或 amixer,通知需要 notify-send,電源動作需要 systemd
- 在 Linux 上,GPU 使用率需要 amdgpu 驅動程式或 nvidia-smi
- 在 macOS 上,重新啟動和關機需要允許 Macro Deck 控制 System Events
開始設定
步驟 1: 確認整合已啟用
在 Macro Deck 的側邊欄中按一下 整合,然後按一下 系統。右上角的開關預設為開啟;若為關閉,請將它開啟。不需要任何設定:概覽 分頁會顯示 此整合沒有可用的設定選項。 如果電腦上缺少某些項目(例如 Linux 上的音量後端),頁面會將其列為問題。
步驟 2: 在按鈕上加入系統動作
在 面板 頁面上按一下一個按鈕。面板必須處於解鎖狀態:右上角顯示 鎖定 按鈕時,即表示已解鎖。編輯器開啟時會選取 短按。按一下 + 新增動作,在 新增動作 對話方塊左側選擇 系統,然後選擇一個動作,例如 靜音/取消靜音 或 啟動應用程式。
步驟 3: 填寫動作
每個動作只會要求所需的內容:
- 啟動應用程式:應用程式、選用的 引數 和 工作目錄,以及 模式。
- 音量動作:音訊裝置,以及 幅度(%) 或 音量(%)。
- 執行命令:Shell 和 命令,也可以選擇 將輸出儲存至變數。
步驟 4: 在按鈕上顯示值
若要顯示某個值,請在按鈕的標籤中輸入變數,例如
CPU {{ vars.system_cpu_usage_percent }} %。系統頁面的 變數 分頁會列出每個系統變數及其目前的值。步驟 5: 按下按鈕
儲存後按下按鈕,或在編輯器中按一下 執行 立即試用動作。
動作17
可放在按鈕上,或從流程中執行。
- 啟動應用程式
- 啟動應用程式,或切換/聚焦執行中的執行個體。
- 開啟網站
- 在預設瀏覽器中開啟網站。
- 開啟檔案
- 以預設應用程式開啟檔案。
- 開啟資料夾
- 在系統的檔案管理員中開啟資料夾。
- 強制結束應用程式
- 依名稱結束執行中的處理程序,可選擇先要求它關閉視窗。
- 提高音量
- 提高所選音訊裝置的音量。
- 降低音量
- 降低所選音訊裝置的音量。
- 靜音/取消靜音
- 切換所選音訊裝置的靜音狀態,並在按鈕上顯示。
- 設定音量
- 將所選音訊裝置的音量設為特定值。
- 傳送通知
- 顯示作業系統的原生通知。
- 顯示 Macro Deck 通知
- 在已連線的裝置和應用程式上,於 Macro Deck 中以簡短訊息或對話方塊顯示訊息。
- 執行命令
- 在所選 Shell 中執行命令列,並可將輸出儲存到變數。
- 鎖定電腦
- 鎖定螢幕,需要輸入密碼或 PIN 才能重新進入。
- 睡眠
- 讓電腦進入睡眠。
- 休眠
- 將工作階段儲存到磁碟並完全關閉電源(Windows 和 Linux)。
- 重新啟動
- 重新啟動電腦,使用 強制 可忽略會阻止重新啟動的應用程式。
- 關機
- 關閉電腦,使用 強制 可忽略會阻止關機的應用程式。
變數12
在按鈕和小工具上顯示這些值,或在條件中使用。
system_volume_percent,system_muted- 預設輸出裝置以百分比表示的音量和靜音狀態。
system_input_volume_percent,system_input_muted- 預設輸入裝置以百分比表示的音量和靜音狀態。
system_audio_output_<device>_*,system_audio_input_<device>_*- 每個喇叭和麥克風以百分比表示的音量(
_volume_percent)和靜音狀態(_muted),例如system_audio_input_usb_mic_muted。 system_cpu_usage_percent,system_cpu_name- 以百分比表示的處理器負載和處理器型號。
system_ram_usage_percent,system_ram_used_gb,system_ram_total_gb- 以百分比表示的記憶體使用率,以及以 GB 為單位的已用記憶體和記憶體總量。
system_gpu_<n>_usage_percent,system_gpu_<n>_name- 每張顯示卡以百分比表示的負載和名稱,從
0開始編號,最多八張。 system_disk_<n>_*- 每個磁碟的名稱、掛載點、檔案系統、大小、已用和可用空間、使用率、讀寫速度和活動,從
0開始編號,最多八個磁碟。 system_date,system_time,system_datetime- 以文字表示的目前日期、時間,以及日期與時間。
system_timestamp_unix,system_day_of_week,system_hour,system_minute- 目前時間的各個部分:Unix 時間戳記、星期幾、小時和分鐘。
system_pc_name,system_os- 電腦名稱和作業系統。
system_locked- 電腦是否已鎖定(Windows 和 macOS)。
system_focused_app,system_focused_app_path,system_focused_app_bundle_id- 位於最前方的應用程式,及其路徑和套件 ID。
常見問題
可以控制特定裝置的音量嗎?
可以。每個音量動作都有 音訊裝置 欄位,包含預設輸出、預設輸入,以及 Macro Deck 偵測過的每個裝置。拔除的裝置會保留在清單中,其變數在裝置接回之前會顯示為無法使用。
可以用滑桿設定音量嗎?
可以。將滑桿繫結到 system_volume_percent 之類的音量變數。也可以用 設定變數 設定音量和靜音變數。若要用一個按鈕切換靜音,請使用 靜音/取消靜音。
為什麼在 macOS 上重新啟動或關機失敗?
macOS 會先要求權限。請在 系統設定 > 隱私權與安全性 > 自動化 > System Events 下允許 Macro Deck。強制 在 macOS 上沒有作用,而 macOS 沒有 休眠。
為什麼在 Linux 上缺少音量、通知或電源動作?
這些功能需要部分發行版未安裝的工具:音量需要 pactl(PulseAudio 或 PipeWire)或 amixer,通知需要 notify-send,電源動作需要 systemctl 或 loginctl。整合 下的 系統 頁面會列出缺少的項目。
執行命令會等待多久?
最多等待 逾時(秒),預設為 30;設為 0 則會等到命令結束。超過時間後仍在執行的命令會繼續執行,除非將其輸出儲存到變數。
Macro Deck 2 的 Windows Utils 按鈕會沿用嗎?
大部分會。從 Macro Deck 2 移轉時,啟動應用程式、開啟檔案或資料夾、命令列和音量等動作會轉換為系統動作,而快速鍵和輸入文字則會轉換為 鍵盤 動作。
更多「你的電腦」整合
鍵盤
隨附於 Macro Deck用按鈕在電腦上按下快速鍵、輸入文字和執行按鍵序列。
滑鼠
隨附於 Macro Deck用按鈕在電腦上點按、移動指標、拖曳和捲動。
ADB / Android Debug Bridge
隨附於 Macro Deck透過 USB 或 Wi-Fi 控制 Android 手機或平板:喚醒裝置、啟動應用程式、點按、輸入文字和擷取螢幕截圖。
Steam
隨附於 Macro Deck啟動和關閉 Steam 遊戲,並在面板上顯示正在玩的遊戲、好友和遊戲庫。