Macro Deck Companion

Macro Deck Companion 集成将 Macro Deck 连接到运行 Macro Deck Companion 应用的手机和平板，支持 Android、iPhone 和 iPad。每台连接的设备都有自己的配置，因此可以在管理其他所有设备的同时，单独向某一台平板发送命令并读取它报告的信息。

设置时无需输入任何内容。在设备上打开 Companion 应用并将其连接到电脑，设备就会以自己的名称自动出现在集成中。

可以做什么

动作每次作用于一台设备。在每个动作的 设备 字段中选择设备：

• 设置屏幕亮度 和 设置方向（自动、竖屏或横屏）适用于 Android、iPhone 和 iPad。
• 振动 适用于 Android 和 iPhone。
• 截取屏幕 截取面板（在 Android 上也可截取整个屏幕），并以 PNG 文件保存到电脑上的文件夹。
• 点亮屏幕、关闭屏幕 和 置于前台 适用于 Android，前提是在应用设置的 设备控制 中允许了这些操作。

每台设备还会以变量报告其状态：电量、是否正在充电、屏幕方向、屏幕亮度、型号、平台、应用版本、Macro Deck 是否处于前台、网络类型和名称，以及 CPU 和内存使用率。可以像其他变量一样在标签、条件和自动化中使用它们。

示例设置

• 一台只用作面板的平板：由 服务器已停止 触发的自动化在 Macro Deck 退出时运行 关闭屏幕，由 设备已就绪 触发的自动化在平板重新连接时运行 点亮屏幕。
• 两个由 系统 集成的 system_locked 变量的 变量已更改 触发的自动化：锁定电脑时关闭平板屏幕，解锁时再点亮。
• 一个 22:00 的 计划 事件运行 设置屏幕亮度 将亮度设为 20 %，另一个在 08:00 恢复。
• 手机面板上的标签显示墙上平板的 companion_<configuration>_battery_level_percent，以便知道它何时需要充电。
• 一个使用 截取屏幕 的按键将面板保存为 PNG 文件，将保存路径写入变量 会把文件路径放入变量，供下一个动作使用。

动作需要设备处于连接状态。设备刚连接时，动作会等待几秒钟直到设备就绪。设备未连接时，其变量显示为不可用，只有 companion_<configuration>_is_connected 为 false。