ADB / Android Debug Bridge
Meegeleverd met Macro DeckBedien een Android-telefoon of -tablet via USB of wifi: wek hem, start apps, tik, typ en maak screenshots.
Het tabblad Overzicht van de integratie ADB / Android Debug Bridge, met een melding om ADB in te schakelen in Instellingen
- Wek, vergrendel en herstart een verbonden Android-apparaat
- Start apps of stop ze geforceerd en open links op het apparaat
- Verstuur toetsen, tikken, veegbewegingen en tekst
- Sla screenshots van het apparaatscherm op in een map
- Apparaatgebeurtenissen en variabelen voor batterij, scherm en voorgrond-app
De integratie ADB bedient Android-telefoons en -tablets via de Android Debug Bridge (ADB), dezelfde tool die Android-ontwikkelaars gebruiken. Macro Deck vindt het programma adb, draait de ADB-server en houdt bij welke apparaten via USB zijn aangesloten of via wifi zijn verbonden. Het kan ook de officiële Android platform-tools voor je downloaden.
Elke actie werkt op het apparaat dat je in de actie kiest, of op het standaardapparaat als je Apparaat leeg laat. Het standaardapparaat is het apparaat dat je met Als standaard instellen hebt gekozen in Instellingen > ADB, of het enige aangesloten apparaat als je er geen hebt gekozen.
Wat je kunt doen
- Scherm en voeding: wek het apparaat, zet het scherm uit (zo vergrendelt Android het apparaat) of herstart het in Android, recovery of de bootloader.
- Apps en links: start een app of stop hem geforceerd op basis van de pakketnaam, zoals
com.spotify.music, en open een link met de app die het apparaat daarvoor kiest. - Invoer: verstuur een toets zoals Home, Back, Volume Up of Media Play Pause, tik op een punt op het scherm, veeg van het ene punt naar het andere of typ tekst in het actieve veld.
- Screenshots: leg het scherm vast als PNG-bestand in een map op je computer en schrijf het pad van het bestand eventueel in een variabele.
Een paar voorbeelden:
- Een knop die een tablet op je bureau wekt en je muziekapp start.
- Een knop die Media Play Pause naar je telefoon stuurt.
- Een automatisering op Apparaat verbonden die een dashboardpagina op een tablet opent zodra je hem aansluit.
Live status
De integratie meldt wanneer een apparaat wordt verbonden, losgekoppeld of geautoriseerd, niet meer geautoriseerd is, offline gaat of weer online komt, zodat actiestromen en knoppen daarop kunnen reageren. Variabelen bevatten het aantal verbonden en geautoriseerde apparaten en, voor het standaardapparaat, het model, de fabrikant, het batterijniveau, of het scherm aan staat, of het vergrendelscherm wordt getoond en welke app op de voorgrond staat. Elk geautoriseerd apparaat krijgt ook eigen variabelen, vernoemd naar het model. Zolang de integratie aan staat, verschijnt de batterij van elk Android-apparaat ook in de widget Batterij.
De basisacties (toetsen, tikken, vegen, tekst, apps, links, herstarten en screenshots) blijven werken terwijl Macro Deck vergrendeld is, zodat een knop met zo'n actie ook op een vergrendelde computer werkt.
Wat je nodig hebt
- Macro Deck 3 op Windows, macOS of Linux
- Een Android-apparaat met USB-foutopsporing ingeschakeld in de ontwikkelaarsopties
- Een USB-kabel die data overdraagt, of draadloze foutopsporing voor een verbinding via wifi
- Android platform-tools (adb); Macro Deck kan ze downloaden in Instellingen > ADB
- Op Linux toestemming voor je gebruiker om het USB-apparaat te gebruiken, meestal via een udev-regel
Instellen
Stap 1: Schakel de integratie ADB in
Klik in de zijbalk op Integraties en daarna op ADB / Android Debug Bridge. De integratie staat uit totdat je de schakelaar rechtsboven aanzet. Zodra hij aan staat, toont de pagina ADB is uitgeschakeld totdat je in de volgende stap ADB inschakelt.
Stap 2: Schakel ADB in Macro Deck in
Open Instellingen > ADB en zet ADB inschakelen aan. Als bij ADB-programma Niet gevonden staat, klik je op Platform-tools downloaden. Een bestaande Android SDK of een
adbin jePATHwordt automatisch gevonden, en met Pad naar uitvoerbaar bestand kun je naar een andere verwijzen.Stap 3: Schakel USB-foutopsporing op het apparaat in
Open op de telefoon of tablet Instellingen > Over de telefoon en tik zeven keer op Buildnummer om de Ontwikkelaarsopties in te schakelen. Zet daarna USB-foutopsporing aan in Instellingen > Ontwikkelaarsopties. De precieze plek verschilt een beetje per fabrikant.
Stap 4: Verbind en autoriseer het apparaat
Sluit het apparaat aan met een USB-kabel en bevestig USB-foutopsporing toestaan? op het scherm. Vink Altijd toestaan vanaf deze computer aan, zodat het niet opnieuw wordt gevraagd. Het apparaat verschijnt dan onder Apparaten in Instellingen > ADB als Gereed. Wil je liever via wifi verbinden, vul dan het IP-adres en de poort van het apparaat in onder Verbinden via Wi-Fi, bijvoorbeeld
192.168.1.20:5555.Stap 5: Kies een standaardapparaat
Als er meer dan één apparaat is aangesloten, klik je op Als standaard instellen naast het apparaat dat je acties moeten gebruiken als je Apparaat leeg laat. Met één apparaat wordt dat automatisch gebruikt.
Stap 6: Voeg een ADB-actie aan een knop toe
Zorg op de pagina Deck dat het deck ontgrendeld is (op de knop rechtsboven staat Vergrendelen) en klik op een knop. De editor opent met Kort indrukken geselecteerd. Klik op + Actie toevoegen, kies links in het dialoogvenster Actie toevoegen voor ADB / Android Debug Bridge en kies een actie, bijvoorbeeld Apparaat wekken of App starten. Vul de velden in, zoals Pakket bij App starten, en laat Apparaat leeg om het standaardapparaat te gebruiken. De categorie verschijnt alleen zolang de integratie is ingeschakeld.
Stap 7: Druk op de knop
Klik op Opslaan en druk op de knop op je deck. Gebeurt er niets, kijk dan onder Integraties of er een melding staat, zoals Geen apparaten verbonden of een apparaat dat autorisatie nodig heeft.
Acties11
Zet deze op een knop of voer ze uit vanuit een actiestroom.
- Apparaat wekken
- Wekt het scherm van het apparaat.
- Slapen / scherm vergrendelen
- Zet het scherm van het apparaat uit; zo vergrendelt Android een apparaat.
- App starten
- Start een app op basis van de pakketnaam, of haalt hem naar de voorgrond.
- App geforceerd stoppen
- Stopt een app geforceerd op basis van de pakketnaam.
- Link openen
- Opent een URI op het apparaat, net als wanneer je op een link tikt.
- Tekst typen
- Typt tekst in het veld dat op het apparaat actief is.
- Toets versturen
- Verstuurt één Android-toetsgebeurtenis, zoals Home, Back, Volume Up of Media Next.
- Tikken
- Tikt op het scherm op de opgegeven X- en Y-coördinaten.
- Vegen
- Veegt over het scherm van het ene punt naar het andere in een ingestelde tijd.
- Apparaat opnieuw opstarten
- Start het apparaat opnieuw op in de modus Normaal, Herstel of Bootloader.
- Schermafbeelding maken
- Legt het scherm van het apparaat vast, slaat het op als PNG-bestand in een map en schrijft het pad eventueel in een variabele.
Triggers6
Een knop of actiestroom kan op deze gebeurtenissen reageren.
- Apparaat verbonden
- Een Android-apparaat is aangesloten, of Macro Deck heeft het voor het eerst gezien.
- Apparaat niet verbonden
- Een Android-apparaat is losgekoppeld, of Macro Deck is het uit het oog verloren.
- Apparaat geautoriseerd
- De autorisatievraag is op het apparaat geaccepteerd.
- Apparaat niet meer geautoriseerd
- Op een eerder geautoriseerd apparaat moet de autorisatievraag opnieuw worden geaccepteerd.
- Apparaat online gegaan
- Een geautoriseerd apparaat is weer bereikbaar.
- Apparaat offline gegaan
- Een apparaat dat bereikbaar was, is niet meer bereikbaar.
Variabelen11
Toon deze waarden op knoppen en widgets, of gebruik ze in voorwaarden.
adb_connected_device_count- Het aantal aangesloten Android-apparaten.
adb_authorized_device_count- Het aantal apparaten dat online en geautoriseerd is.
adb_device_connected- Of het standaardapparaat verbonden is.
adb_device_authorized- Of het standaardapparaat deze computer heeft geautoriseerd.
adb_device_model- Het model van het standaardapparaat.
adb_device_manufacturer- De fabrikant van het standaardapparaat.
adb_device_battery_level- Het batterijniveau van het standaardapparaat in procent.
adb_device_screen_on- Of het scherm van het standaardapparaat aan staat.
adb_device_locked- Of het standaardapparaat het vergrendelscherm toont.
adb_device_foreground_app- De pakketnaam van de app die op het standaardapparaat op de voorgrond staat.
adb_device_<device>_connected,adb_device_<device>_authorized,adb_device_<device>_model,adb_device_<device>_battery_level- Verbonden, geautoriseerd, model en batterijniveau van elk geautoriseerd apparaat.
<device>is het model van het apparaat in kleine letters, cijfers en underscores, met_2,_3enzovoort erachter voor meer apparaten van hetzelfde model.
Veelgestelde vragen
Heb ik Android Studio of de Android SDK nodig?
Nee. Macro Deck heeft alleen het programma adb uit de Android platform-tools nodig. Klik op Platform-tools downloaden in Instellingen > ADB, dan downloadt Macro Deck het officiële pakket van Google, ongeveer 15 MB, voor eigen gebruik. Een bestaande installatie wordt automatisch gevonden.
Kan ik een apparaat via wifi bedienen?
Ja. Schakel draadloze foutopsporing op het apparaat in en vul het IP-adres en de poort in onder Verbinden via Wi-Fi in Instellingen > ADB. Macro Deck koppelt zelf geen apparaten: koppel het apparaat op Android 11 en nieuwer eerst met deze computer, of zet het via USB met adb tcpip in netwerkfoutopsporing. Anders weigert het apparaat de verbinding.
Waarom mislukt een actie omdat er geen apparaat is gevonden?
Als je Apparaat leeg laat, gebruikt de actie het standaardapparaat. Heb je er geen gekozen en zijn er meerdere apparaten aangesloten, dan is er geen standaardapparaat. Kies dan een apparaat in de actie of klik op Als standaard instellen in Instellingen > ADB. Controleer ook of het apparaat Gereed toont en niet Niet geautoriseerd.
Is er een aparte vergrendelactie?
Nee. Android heeft geen apart vergrendelcommando. Slapen / scherm vergrendelen zet het scherm uit, wat het apparaat op dezelfde manier vergrendelt als de aan-uitknop.
Heeft de integratie ADB invloed op andere programma's die ADB gebruiken?
Macro Deck gebruikt de normale ADB-server, dus programma's zoals Android Studio delen die. ADB-server opnieuw starten in Instellingen > ADB verbreekt ook kort de verbinding met hun apparaten. Macro Deck laat de server draaien wanneer het wordt afgesloten, tenzij je ADB-server stoppen wanneer Macro Deck wordt afgesloten inschakelt.
Waarom toont het apparaat "Geen toestemming om dit apparaat te gebruiken"?
De computer heeft geen toestemming om via USB met het apparaat te communiceren. Installeer op Linux de udev-regels van de platform-tools; installeer op Windows het USB-stuurprogramma van de fabrikant voor het apparaat.
Meer in Je computer
Systeem
Meegeleverd met Macro DeckBedien je computer vanaf je deck: apps, volume, opdrachten, meldingen, slaapstand en uitschakelen.
Toetsenbord
Meegeleverd met Macro DeckDruk sneltoetsen, typ tekst en voer toetsreeksen uit op je computer vanaf een knop.
Muis
Meegeleverd met Macro DeckKlik, verplaats de aanwijzer, sleep en scrol op je computer vanaf een knop.
Steam
Meegeleverd met Macro DeckStart en sluit Steam-games, en toon wat je speelt, je vrienden en je bibliotheek op je deck.