Macro Deck Companion

Macro Deck Companion 整合會將 Macro Deck 連線到執行 Android、iPhone 和 iPad 版 Macro Deck Companion App 的手機和平板。每台連線的裝置都有自己的設定，因此可以在使用其他所有裝置的同時，將指令傳送到某一台特定的平板，並讀取它回報的內容。

設定時不需要輸入任何內容。在裝置上開啟 Companion App 並連線到電腦，裝置就會自動以自己的名稱出現在此整合中。

可以做什麼

動作一次只對一台裝置執行。在每個動作的 裝置 欄位中選擇裝置：

• 設定螢幕亮度 和 設定螢幕方向（自動、直向或橫向）適用於 Android、iPhone 和 iPad。
• 震動 適用於 Android 和 iPhone。
• 擷取螢幕畫面 會擷取面板（在 Android 上可擷取整個螢幕），並以 PNG 檔案儲存在電腦上的資料夾中。
• 開啟螢幕、關閉螢幕 和 移至前景 適用於 Android，需先在 App 設定的 裝置控制 下允許。

每台裝置也會以變數回報其狀態：電池電量、充電狀態、螢幕方向、螢幕亮度、型號、平台、App 版本、Macro Deck 是否位於前景、網路類型和名稱，以及 CPU 和記憶體使用率。可以像其他變數一樣在標籤、條件和自動化中使用。

設定範例

• 專門作為面板使用的平板：伺服器已停止 上的自動化會在 Macro Deck 結束時執行 關閉螢幕，裝置就緒 上的自動化會在平板重新連線時執行 開啟螢幕。
• 兩個針對 系統 整合 system_locked 變數的 變數已變更 自動化，會在鎖定電腦時關閉平板螢幕，解除鎖定時再重新開啟。
• 22:00 的 排程 事件執行 設定螢幕亮度 為 20 %，另一個 08:00 的事件再將它調回來。
• 手機面板上的標籤顯示牆上平板的 companion_<configuration>_battery_level_percent，就能知道何時需要充電。
• 使用 擷取螢幕畫面 的按鈕會將面板儲存為 PNG 檔案，而 將儲存路徑寫入變數 會將檔案路徑放入變數，供下一個動作使用。

動作需要裝置已連線。裝置剛連線時，動作會等待幾秒讓它就緒。裝置未連線時，除了 companion_<configuration>_is_connected 會顯示為 false 之外，其變數都會顯示為無法使用。