ADB / Android Debug Bridge
Входить до Macro DeckКеруйте телефоном або планшетом Android через USB чи Wi-Fi: вмикайте екран, запускайте застосунки, натискайте, вводьте текст і робіть знімки екрана.
Вкладка «Огляд» інтеграції ADB / Android Debug Bridge з повідомленням про потребу ввімкнути ADB у налаштуваннях
- Вмикайте екран, блокуйте й перезавантажуйте підключений пристрій Android
- Запускайте або примусово зупиняйте застосунки й відкривайте посилання на пристрої
- Надсилайте клавіші, натискання, проведення й текст
- Зберігайте знімки екрана пристрою в папку
- Події та змінні пристрою для батареї, екрана й застосунку на передньому плані
Інтеграція ADB керує телефонами й планшетами Android через Android Debug Bridge (ADB), той самий інструмент, яким користуються розробники Android. Macro Deck знаходить програму adb, запускає сервер ADB і стежить за пристроями, підключеними через USB або Wi-Fi. Також він може сам завантажити офіційні Android platform-tools.
Кожна дія працює з пристроєм, вибраним у дії, або з типовим пристроєм, якщо поле Пристрій залишити порожнім. Типовий пристрій - це той, для якого ви натиснули Зробити типовим у розділі Налаштування > ADB, або єдиний підключений пристрій, якщо ви нічого не вибрали.
Що можна робити
- Екран і живлення: вмикати екран пристрою, вимикати його (так Android блокує пристрій) або перезавантажувати пристрій в Android, режим відновлення (recovery) чи завантажувач (bootloader).
- Застосунки й посилання: запускати застосунок або примусово зупиняти його за назвою пакета, наприклад
com.spotify.music, і відкривати посилання в застосунку, який для нього вибере пристрій. - Введення: надсилати клавішу, як-от Home, Back, Volume Up або Media Play Pause, натискати точку на екрані, проводити від однієї точки до іншої або вводити текст у поле, що має фокус.
- Знімки екрана: зберігати екран як файл PNG у папці на комп’ютері й за бажанням записувати шлях до файлу в змінну.
Кілька прикладів:
- Кнопка, яка вмикає екран планшета на столі й запускає музичний застосунок.
- Кнопка, яка надсилає на телефон Media Play Pause.
- Автоматизація за тригером Пристрій підключено, яка відкриває сторінку з панеллю на планшеті, щойно ви його під’єднаєте.
Стан у реальному часі
Інтеграція повідомляє, коли пристрій підключено, відключено, авторизовано, коли він втратив авторизацію, став недоступним або знову доступний, тож потоки й кнопки можуть на це реагувати. Змінні містять кількість підключених і авторизованих пристроїв, а для типового пристрою ще й модель, виробника, рівень заряду, чи ввімкнено екран, чи показано екран блокування і який застосунок на передньому плані. Кожен авторизований пристрій також отримує власні змінні, названі за його моделлю. Поки інтеграцію ввімкнено, заряд кожного пристрою Android також показується у віджеті «Акумулятор».
Основні дії (клавіші, натискання, проведення, текст, застосунки, посилання, перезавантаження та знімки екрана) працюють і тоді, коли Macro Deck заблоковано, тож прив’язана до них кнопка спрацює й на заблокованому комп’ютері.
Що потрібно
- Macro Deck 3 у Windows, macOS або Linux
- Пристрій Android з увімкненим налагодженням USB у параметрах розробника
- Кабель USB, що передає дані, або бездротове налагодження для підключення через Wi-Fi
- Android platform-tools (adb); Macro Deck може завантажити їх у розділі «Налаштування > ADB»
- У Linux - дозвіл для вашого користувача на доступ до пристрою USB, зазвичай через правило udev
Як налаштувати
Крок 1: Увімкніть інтеграцію ADB
На бічній панелі натисніть Інтеграції, а потім ADB / Android Debug Bridge. Інтеграція вимкнена, доки ви не ввімкнете перемикач угорі праворуч. Після ввімкнення сторінка показує ADB вимкнено, доки ви не ввімкнете ADB на наступному кроці.
Крок 2: Увімкніть ADB у Macro Deck
Відкрийте Налаштування > ADB і ввімкніть Увімкнути ADB. Якщо в полі Програма ADB показано Не знайдено, натисніть Завантажити platform-tools. Наявний Android SDK або
adbу зміннійPATHбуде знайдено автоматично, а в полі Шлях до виконуваного файлу можна вказати інший.Крок 3: Увімкніть налагодження USB на пристрої
На телефоні або планшеті відкрийте Settings > About phone і сім разів торкніться Build number, щоб увімкнути Developer options. Потім увімкніть USB debugging у Settings > Developer options. Точне розташування трохи відрізняється залежно від виробника.
Крок 4: Підключіть і авторизуйте пристрій
Підключіть пристрій кабелем USB і підтвердьте запит Allow USB debugging? на його екрані. Позначте Always allow from this computer, щоб запит більше не з’являвся. Після цього пристрій з’явиться в списку Пристрої в розділі Налаштування > ADB зі станом Готово. Щоб натомість підключитися через Wi-Fi, введіть IP-адресу й порт пристрою в розділі Підключитися через Wi-Fi, наприклад
192.168.1.20:5555.Крок 5: Виберіть типовий пристрій
Якщо підключено кілька пристроїв, натисніть Зробити типовим біля того, який мають використовувати дії з порожнім полем Пристрій. Якщо пристрій один, він використовується автоматично.
Крок 6: Додайте дію ADB на кнопку
На сторінці Панель переконайтеся, що панель розблоковано (кнопка вгорі праворуч показує Заблокувати), і клацніть кнопку. Відкриється редактор із вибраним Коротке натискання. Натисніть + Додати дію, виберіть ADB / Android Debug Bridge ліворуч у діалозі Додати дію і виберіть дію, наприклад Розбудити пристрій або Запустити застосунок. Заповніть її поля, наприклад Пакет для Запустити застосунок, а поле Пристрій залиште порожнім, щоб використовувати типовий пристрій. Категорія з’являється, лише поки інтеграцію ввімкнено.
Крок 7: Натисніть кнопку
Натисніть Зберегти і натисніть кнопку на своїй панелі. Якщо нічого не відбувається, перевірте в розділі Інтеграції, чи немає там повідомлення, наприклад Немає підключених пристроїв, або пристрою, який потребує авторизації.
Дії11
Призначте їх кнопці або запускайте з потоку.
- Розбудити пристрій
- Вмикає екран пристрою.
- Сон / блокування екрана
- Вимикає екран пристрою. Саме так Android блокує пристрій.
- Запустити застосунок
- Запускає застосунок за назвою пакета або виводить його на передній план.
- Примусово зупинити застосунок
- Примусово зупиняє застосунок за назвою пакета.
- Відкрити посилання
- Відкриває URI на пристрої, так само як натискання на посилання.
- Ввести текст
- Вводить текст у поле, яке зараз має фокус на пристрої.
- Надіслати клавішу
- Надсилає одну подію клавіші Android, наприклад Home, Back, Volume Up або Media Next.
- Натискання
- Натискає на екран у точці з заданими координатами X і Y.
- Проведення
- Проводить по екрану від однієї точки до іншої за заданий час.
- Перезавантажити пристрій
- Перезавантажує пристрій у режим «Звичайний», «Відновлення» або «Завантажувач».
- Зробити знімок екрана
- Знімає екран пристрою й зберігає його як файл PNG у папці, за бажанням записуючи шлях у змінну.
Тригери6
Кнопка або потік можуть реагувати на ці події.
- Пристрій підключено
- Пристрій Android під’єднали, або Macro Deck уперше його побачив.
- Пристрій відключено
- Пристрій Android від’єднали, або Macro Deck його втратив.
- Пристрій авторизовано
- Запит на авторизацію на пристрої прийнято.
- Пристрій втратив авторизацію
- Раніше авторизований пристрій потребує повторного підтвердження запиту на авторизацію.
- Пристрій знову доступний
- Авторизований пристрій знову став доступним.
- Пристрій став недоступним
- Пристрій, який був доступний, більше не відповідає.
Змінні11
Показуйте ці значення на кнопках і віджетах або використовуйте їх в умовах.
adb_connected_device_count- Кількість підключених пристроїв Android.
adb_authorized_device_count- Кількість пристроїв, які в мережі й авторизовані.
adb_device_connected- Чи підключено типовий пристрій.
adb_device_authorized- Чи авторизував типовий пристрій цей комп’ютер.
adb_device_model- Модель типового пристрою.
adb_device_manufacturer- Виробник типового пристрою.
adb_device_battery_level- Рівень заряду батареї типового пристрою у відсотках.
adb_device_screen_on- Чи ввімкнено екран типового пристрою.
adb_device_locked- Чи показує типовий пристрій екран блокування.
adb_device_foreground_app- Назва пакета застосунку на передньому плані типового пристрою.
adb_device_<device>_connected,adb_device_<device>_authorized,adb_device_<device>_model,adb_device_<device>_battery_level- Підключення, авторизація, модель і рівень заряду кожного авторизованого пристрою.
<device>- це модель пристрою малими літерами, цифрами й підкресленнями, а для інших пристроїв тієї самої моделі додається_2,_3і так далі.
Поширені запитання
Чи потрібні Android Studio або Android SDK?
Ні. Macro Deck потрібна лише програма adb з Android platform-tools. Натисніть Завантажити platform-tools у розділі Налаштування > ADB, і Macro Deck завантажить для власного використання офіційний пакет від Google розміром близько 15 МБ. Наявну інсталяцію буде знайдено автоматично.
Чи можна керувати пристроєм через Wi-Fi?
Так. Увімкніть на пристрої бездротове налагодження й введіть його IP-адресу та порт у розділі Підключитися через Wi-Fi в Налаштування > ADB. Macro Deck сам не створює пару з пристроями: в Android 11 і новіших спершу з’єднайте пристрій у пару з цим комп’ютером або переведіть його в режим налагодження через мережу по USB командою adb tcpip. Інакше пристрій відхилить підключення.
Чому дія завершується помилкою, що пристрій не знайдено?
Якщо поле Пристрій порожнє, дія використовує типовий пристрій. Якщо ви його не вибрали, а підключено кілька пристроїв, типового немає, тож виберіть пристрій у дії або натисніть Зробити типовим у розділі Налаштування > ADB. Також перевірте, що пристрій має стан Готово, а не Не авторизовано.
Чи є окрема дія для блокування?
Ні. В Android немає окремої команди блокування. Сон / блокування екрана вимикає екран, і пристрій блокується так само, як від кнопки живлення.
Чи впливає інтеграція ADB на інші програми, що використовують ADB?
Macro Deck використовує звичайний сервер ADB, тож програми на кшталт Android Studio працюють з тим самим сервером. Перезапустити сервер ADB у розділі Налаштування > ADB ненадовго відключає і їхні пристрої. Під час виходу Macro Deck залишає сервер запущеним, якщо ви не ввімкнете Зупиняти сервер ADB під час виходу з Macro Deck.
Чому пристрій показує «Немає дозволу на доступ до цього пристрою»?
Комп’ютер не має дозволу на зв’язок із пристроєм через USB. У Linux установіть правила udev з platform-tools; у Windows установіть драйвер USB від виробника пристрою.
Більше в категорії «Ваш комп’ютер»
Система
Входить до Macro DeckКеруйте комп’ютером зі своєї панелі: застосунки, гучність, команди, сповіщення, сон і вимкнення.
Клавіатура
Входить до Macro DeckНатискайте комбінації клавіш, вводьте текст і виконуйте послідовності клавіш на комп’ютері однією кнопкою.
Миша
Входить до Macro DeckКлацайте, переміщуйте вказівник, перетягуйте й прокручуйте на комп’ютері однією кнопкою.
Steam
Входить до Macro DeckЗапускайте й закривайте ігри Steam і показуйте на панелі, у що ви граєте, своїх друзів і бібліотеку.