Macro Deck Companion
Входит в Macro DeckУправляйте телефонами и планшетами с приложением Companion: яркость, поворот, экран и снимки экрана.
Диалог «Подключение устройства» интеграции Macro Deck Companion, в котором нет полей
- Яркость экрана и ориентация устройства
- Включение и выключение экрана на Android
- Сохранение снимков экрана панели в файлы PNG на компьютере
- Заряд батареи, сеть и память каждого устройства в виде переменных
- Триггер «Устройство готово» при подключении устройства
Интеграция Macro Deck Companion подключает Macro Deck к телефонам и планшетам с приложением Macro Deck Companion для Android, iPhone и iPad. Каждое подключившееся устройство получает собственную настройку, поэтому можно отправлять команды одному определённому планшету и считывать то, что он сообщает, наряду со всеми остальными устройствами.
Для настройки ничего вводить не нужно. Откройте приложение Companion на устройстве и подключите его к компьютеру. После этого устройство само появится в интеграции под своим именем.
Что можно делать
Действия работают с одним устройством за раз. Устройство выбирается в поле Устройство каждого действия:
- Задать яркость экрана и Задать ориентацию (автоматически, портретная или альбомная) работают на Android, iPhone и iPad.
- Вибрация работает на Android и iPhone.
- Сделать снимок экрана снимает панель, а на Android весь экран, и сохраняет снимок как файл PNG в папку на компьютере.
- Включить экран, Выключить экран и Вывести на передний план работают на Android после того, как вы разрешите их в разделе Управление устройством в настройках приложения.
Каждое устройство также сообщает своё состояние в виде переменных: уровень заряда, зарядку, ориентацию, яркость экрана, модель, платформу, версию приложения, находится ли Macro Deck на переднем плане, тип и название сети, загрузку ЦП и памяти. Используйте их в подписях, условиях и автоматизациях, как любые другие переменные.
Примеры
- Планшет, который служит только панелью: автоматизация по триггеру Сервер остановлен выполняет Выключить экран, когда Macro Deck завершает работу, а автоматизация по триггеру Устройство готово выполняет Включить экран, когда планшет снова на связи.
- Две автоматизации по триггеру Переменная изменена для переменной
system_lockedинтеграции Система выключают экран планшета, когда вы блокируете компьютер, и снова включают его при разблокировке. - Событие Расписание в 22:00 выполняет Задать яркость экрана на 20 %, а ещё одно в 08:00 возвращает яркость обратно.
- Подпись на панели телефона показывает
companion_<configuration>_battery_level_percentпланшета на стене, чтобы вы видели, когда его пора зарядить. - Кнопка с действием Сделать снимок экрана сохраняет панель как файл PNG, а Путь сохранения в переменную записывает путь к файлу в переменную для следующего действия.
Для действия устройство должно быть подключено. Если оно только что подключилось, действие несколько секунд ждёт, пока оно будет готово. Пока устройство не подключено, его переменные считаются недоступными, кроме companion_<configuration>_is_connected, которая равна false.
Что понадобится
- Macro Deck 3 на компьютере
- Приложение Macro Deck Companion на Android 6 или новее либо iOS и iPadOS 15 или новее
- Лицензия приложения Companion или бесплатный пробный период на 7 дней
- Устройство в той же сети, что и компьютер, или подключённое по USB
- На Android: разрешения в разделе «Управление устройством» в приложении для включения и выключения экрана и вывода на передний план
Настройка
Шаг 1: Установите приложение Companion
Установите Macro Deck Companion из Google Play или App Store на телефон или планшет. Начните бесплатный пробный период на 7 дней или купите лицензию.
Шаг 2: Подключите устройство к Macro Deck
В Macro Deck на компьютере откройте панель сети с помощью значка сети справа вверху. В приложении нажмите Добавить подключение (на iPhone и iPad +), выберите Сканировать QR-код и отсканируйте код на панели. Также можно выбрать компьютер в разделе Найдено в этой сети или ввести его адрес.
Шаг 3: Найдите устройство в интеграции
На боковой панели нажмите Интеграции, а затем Macro Deck Companion. Как только устройство подключится, оно само появится со своим именем в разделе Настройка на вкладке Обзор, а переключатель в правом верхнем углу будет включён. Если вы раньше выключили интеграцию, снова включите переключатель. Добавить настройку открывает диалог Подключение устройства, в котором нет полей: он только объясняет это. Переименовать меняет имя, которое Macro Deck использует для устройства.
Шаг 4: Разрешите управление устройством на Android
Чтобы включать и выключать экран или выводить панель на передний план, откройте настройки приложения на устройстве Android и включите разрешения в разделе Управление устройством. Для действия Включить экран также нужны разрешения Фоновое подключение и Поверх других приложений, чтобы устройство оставалось подключённым при выключенном экране.
Шаг 5: Добавьте действие Companion на кнопку
На странице Панель убедитесь, что панель разблокирована (кнопка в правом верхнем углу называется Заблокировать), и нажмите на кнопку. Откроется редактор, в котором выбран триггер Короткое нажатие. Нажмите + Добавить действие, слева в диалоге Добавить действие выберите Macro Deck Companion и затем действие, например Задать яркость экрана. Выберите устройство в поле Устройство и задайте значение.
Шаг 6: Нажмите кнопку
Нажмите Сохранить и нажмите кнопку на любой из своих панелей. Устройство выполнит команду, пока оно подключено к Macro Deck.
Действия7
Назначьте их на кнопку или запускайте из цепочки действий.
- Задать яркость экрана
- Задаёт яркость экрана устройства Companion от 0 до 100 %.
- Задать ориентацию
- Фиксирует портретную или альбомную ориентацию устройства Companion или разрешает автоматический поворот.
- Вибрация
- Заставляет устройство Companion ненадолго завибрировать (Android и iPhone).
- Включить экран
- Включает экран устройства Companion и показывает этот Macro Deck (Android).
- Выключить экран
- Выключает экран устройства Companion (Android).
- Вывести на передний план
- Выводит панель этого Macro Deck на передний план на устройстве Companion (Android).
- Сделать снимок экрана
- Снимает панель или, на Android, весь экран устройства и сохраняет снимок как файл PNG в папку на компьютере.
Триггеры1
Кнопка или цепочка действий может реагировать на эти события.
- Устройство готово
- Срабатывает, когда приложение Companion подключилось и может выполнять действия Companion, при желании только для одного устройства.
Переменные15
Показывайте эти значения на кнопках и виджетах или используйте их в условиях.
companion_<configuration>_is_connected- Подключено ли устройство прямо сейчас.
companion_<configuration>_battery_level_percent- Заряд батареи в процентах.
companion_<configuration>_charging- Заряжается ли устройство.
companion_<configuration>_orientation- В портретной или альбомной ориентации находится устройство.
companion_<configuration>_screen_brightness_percent- Яркость экрана в процентах.
companion_<configuration>_model- Модель устройства.
companion_<configuration>_platform- Операционная система и её версия, например
Android 14. companion_<configuration>_app_version- Версия приложения Companion.
companion_<configuration>_in_focus- Находится ли Macro Deck на переднем плане на устройстве.
companion_<configuration>_network_type- Тип сети: Wi-Fi, мобильная сеть, Ethernet, VPN или нет сети.
companion_<configuration>_network_metered- Является ли сеть лимитированной.
companion_<configuration>_network_validated- Есть ли в сети доступ в интернет.
companion_<configuration>_network_name- Название сети Wi-Fi, на Android при разрешении «Имя сети Wi-Fi».
companion_<configuration>_cpu_usage_percent- Загрузка ЦП в процентах, на iOS.
companion_<configuration>_memory_used_percent- Используемая память в процентах.
Часто задаваемые вопросы
Нужно ли приложение Companion, чтобы пользоваться Macro Deck на телефоне?
Нет. Любое устройство с современным браузером может пользоваться бесплатным веб-клиентом. Действиям и переменным этой интеграции нужно приложение Companion, потому что браузер не может управлять самим устройством.
Почему «Включить экран» или «Выключить экран» не срабатывают?
Эти действия работают только на Android и только с разрешениями в разделе Управление устройством в настройках приложения. Для действия Включить экран также нужны разрешения Фоновое подключение и Поверх других приложений, чтобы устройство оставалось подключённым при выключенном экране. На iPhone и iPad приложение не может включать и выключать экран.
Что происходит, когда устройство не подключено?
Действие для этого устройства завершается с ошибкой Устройство Companion не подключено. Его переменные считаются недоступными, а companion_<configuration>_is_connected равна false. Когда устройство снова подключится, сработает триггер Устройство готово и переменные обновятся.
Можно ли использовать несколько телефонов и планшетов?
Да. Каждое подключившееся устройство получает собственную настройку с собственными переменными. В каждом действии устройство выбирается в поле Устройство.
Где сохраняются снимки экрана?
На компьютере, где работает Macro Deck, в папке, выбранной в поле Папка действия, с именем companion-screenshot-<date>-<time>.png. Для снимка панели она должна отображаться на экране устройства. Снимок всего экрана работает только на Android, после того как вы разрешите его на устройстве.
Могут ли плагины тоже использовать мои устройства Companion?
Только пока включено Разрешить плагинам использовать устройства Companion в группе Доступ плагинов в разделе Настройки > Приложение Companion. По умолчанию этот параметр выключен. На собственные действия, переменные и триггер этой интеграции он не влияет.
Ещё в группе «Macro Deck»
Macro Deck Delegate
Входит в Macro DeckЗапускайте скрипты на другом ПК с Macro Deck и используйте переменные, которыми он делится.
Скрипты
Входит в Macro DeckСоберите набор действий один раз в виде скрипта и запускайте его с любой кнопки, из автоматизации или другого скрипта.
Переменные
Входит в Macro DeckМеняйте свои переменные с кнопок и из автоматизаций и записывайте любую переменную в файл.