ADB / Android Debug Bridge
Součást Macro DeckOvládejte telefon nebo tablet s Androidem přes USB nebo Wi-Fi: probuďte ho, spouštějte aplikace, klepejte, pište a pořizujte snímky obrazovky.
Karta Přehled integrace ADB / Android Debug Bridge s upozorněním, že je potřeba zapnout ADB v Nastavení
- Probuzení, uzamčení a restart připojeného zařízení s Androidem
- Spuštění nebo vynucené ukončení aplikací a otevírání odkazů v zařízení
- Odesílání kláves, klepnutí, přejetí a textu
- Ukládání snímků obrazovky zařízení do složky
- Události a proměnné zařízení pro baterii, obrazovku a aplikaci v popředí
Integrace ADB ovládá telefony a tablety s Androidem přes Android Debug Bridge (ADB), stejný nástroj, jaký používají vývojáři pro Android. Macro Deck najde program adb, spustí server ADB a sleduje zařízení připojená přes USB nebo Wi-Fi. Oficiální Android platform-tools vám také umí stáhnout.
Každá akce pracuje se zařízením, které v akci vyberete, nebo s výchozím zařízením, když pole Zařízení necháte prázdné. Výchozí zařízení je to, které jste zvolili pomocí Nastavit jako výchozí v Nastavení > ADB, nebo jediné připojené zařízení, pokud jste žádné nezvolili.
Co můžete dělat
- Obrazovka a napájení: probudit zařízení, vypnout obrazovku (Android tím zařízení uzamkne) nebo ho restartovat do Androidu, režimu recovery nebo bootloaderu.
- Aplikace a odkazy: spustit aplikaci nebo ji vynuceně ukončit podle názvu balíčku, například
com.spotify.music, a otevřít odkaz v aplikaci, kterou pro něj zařízení zvolí. - Vstup: odeslat klávesu jako Home, Back, Volume Up nebo Media Play Pause, klepnout na bod na obrazovce, přejet z jednoho bodu do druhého nebo napsat text do aktivního pole.
- Snímky obrazovky: zachytit obrazovku jako soubor PNG do složky v počítači a volitelně zapsat cestu k souboru do proměnné.
Několik příkladů použití:
- Tlačítko, které probudí tablet na stole a spustí hudební aplikaci.
- Tlačítko, které do telefonu odešle Media Play Pause.
- Automatizace s triggerem Zařízení připojeno, která na tabletu otevře stránku s přehledem, jakmile ho připojíte.
Živý stav
Integrace hlásí, když se zařízení připojí, odpojí, autorizuje, ztratí autorizaci, přejde do režimu offline nebo se vrátí online, takže na to postupy a tlačítka můžou reagovat. Proměnné obsahují počet připojených a autorizovaných zařízení a pro výchozí zařízení jeho model, výrobce, stav baterie, zda je obrazovka zapnutá, zda se zobrazuje zamykací obrazovka a která aplikace je v popředí. Každé autorizované zařízení má navíc vlastní proměnné pojmenované podle svého modelu. Když je integrace zapnutá, zobrazuje se baterie každého zařízení s Androidem také ve widgetu Baterie.
Základní akce (klávesy, klepnutí, přejetí, text, aplikace, odkazy, restarty a snímky obrazovky) fungují i tehdy, když je Macro Deck uzamčený, takže tlačítko s takovou akcí funguje i na uzamčeném počítači.
Co budete potřebovat
- Macro Deck 3 na Windows, macOS nebo Linuxu
- Zařízení s Androidem se zapnutým USB debugging v Developer options
- Datový kabel USB, nebo bezdrátové ladění pro připojení přes Wi-Fi
- Android platform-tools (adb); Macro Deck je umí stáhnout v Nastavení > ADB
- Na Linuxu oprávnění vašeho uživatele k přístupu k zařízení USB, obvykle pomocí pravidla udev
Nastavení
Krok 1: Zapněte integraci ADB
Na postranním panelu klikněte na Integrace a pak na ADB / Android Debug Bridge. Integrace je vypnutá, dokud nezapnete přepínač vpravo nahoře. Jakmile je zapnutá, stránka zobrazuje ADB je vypnuté, dokud v dalším kroku nezapnete ADB.
Krok 2: Povolte ADB v Macro Deck
Otevřete Nastavení > ADB a zapněte Povolit ADB. Pokud Program ADB ukazuje Nenalezeno, klikněte na Stáhnout platform-tools. Existující Android SDK nebo
adbve vaší proměnnéPATHse najde automaticky a v poli Cesta ke spustitelnému souboru můžete zadat jiný.Krok 3: Zapněte USB debugging v zařízení
V telefonu nebo tabletu otevřete Settings > About phone a sedmkrát klepněte na Build number, čímž zapnete Developer options. Pak v Settings > Developer options zapněte USB debugging. Přesné umístění se u jednotlivých výrobců mírně liší.
Krok 4: Připojte a autorizujte zařízení
Připojte zařízení kabelem USB a na jeho obrazovce potvrďte Allow USB debugging?. Zaškrtněte Always allow from this computer, aby se už znovu neptalo. Zařízení se pak v Nastavení > ADB zobrazí v části Zařízení jako Připraveno. Chcete-li se místo toho připojit přes Wi-Fi, zadejte IP adresu a port zařízení v části Připojit přes Wi-Fi, například
192.168.1.20:5555.Krok 5: Zvolte výchozí zařízení
Pokud je připojeno víc zařízení, klikněte na Nastavit jako výchozí u toho, které mají akce používat, když pole Zařízení necháte prázdné. Jediné zařízení se použije automaticky.
Krok 6: Přidejte akci ADB na tlačítko
Na stránce Deck se ujistěte, že je deck odemčený (tlačítko vpravo nahoře ukazuje Uzamknout), a klikněte na tlačítko. Otevře se editor s vybranou možností Krátké stisknutí. Klikněte na + Přidat akci, v dialogu Přidat akci vlevo zvolte ADB / Android Debug Bridge a vyberte akci, například Probudit zařízení nebo Spustit aplikaci. Vyplňte její pole, například Balíček u akce Spustit aplikaci, a pole Zařízení nechte prázdné, aby se použilo výchozí zařízení. Kategorie se zobrazuje jen tehdy, když je integrace zapnutá.
Krok 7: Stiskněte tlačítko
Klikněte na Uložit a stiskněte tlačítko na decku. Pokud se nic nestane, podívejte se v Integrace, zda se nezobrazuje upozornění, například Žádná zařízení nejsou připojena nebo zařízení, které čeká na autorizaci.
Akce11
Umístěte je na tlačítko nebo je spusťte z postupu.
- Probudit zařízení
- Probudí obrazovku zařízení.
- Uspat / uzamknout obrazovku
- Vypne obrazovku zařízení, čímž ho Android uzamkne.
- Spustit aplikaci
- Spustí aplikaci podle názvu balíčku nebo ji přenese do popředí.
- Vynuceně ukončit aplikaci
- Vynuceně ukončí aplikaci podle názvu balíčku.
- Otevřít odkaz
- Otevře URI v zařízení, stejně jako klepnutí na odkaz.
- Napsat text
- Napíše text do pole, které je v zařízení právě aktivní.
- Odeslat klávesu
- Odešle jednu událost klávesy Androidu, například Home, Back, Volume Up nebo Media Next.
- Klepnutí
- Klepne na obrazovku na zadaných souřadnicích X a Y.
- Přejetí prstem
- Přejede po obrazovce z jednoho bodu do druhého po nastavenou dobu.
- Restartovat zařízení
- Restartuje zařízení do režimu Normální, Recovery nebo Bootloader.
- Pořídit snímek obrazovky
- Zachytí obrazovku zařízení a uloží ji jako soubor PNG do složky, volitelně s cestou k souboru zapsanou do proměnné.
Triggery6
Tlačítko nebo postup může na tyto události reagovat.
- Zařízení připojeno
- Zařízení s Androidem bylo připojeno nebo ho Macro Deck poprvé zaznamenal.
- Zařízení odpojeno
- Zařízení s Androidem bylo odpojeno nebo ho Macro Deck přestal vidět.
- Zařízení ověřeno
- V zařízení byla potvrzena výzva k autorizaci.
- Ověření zařízení bylo zrušeno
- Dříve autorizované zařízení vyžaduje znovu potvrdit výzvu k autorizaci.
- Zařízení přešlo do režimu online
- Autorizované zařízení je opět dostupné.
- Zařízení přešlo do režimu offline
- Zařízení, které bylo dostupné, už dostupné není.
Proměnné11
Zobrazte tyto hodnoty na tlačítkách a widgetech nebo je použijte v podmínkách.
adb_connected_device_count- Počet připojených zařízení s Androidem.
adb_authorized_device_count- Počet zařízení, která jsou online a autorizovaná.
adb_device_connected- Zda je výchozí zařízení připojené.
adb_device_authorized- Zda výchozí zařízení autorizovalo tento počítač.
adb_device_model- Model výchozího zařízení.
adb_device_manufacturer- Výrobce výchozího zařízení.
adb_device_battery_level- Stav baterie výchozího zařízení v procentech.
adb_device_screen_on- Zda je obrazovka výchozího zařízení zapnutá.
adb_device_locked- Zda výchozí zařízení zobrazuje zamykací obrazovku.
adb_device_foreground_app- Název balíčku aplikace, která je na výchozím zařízení v popředí.
adb_device_<device>_connected,adb_device_<device>_authorized,adb_device_<device>_model,adb_device_<device>_battery_level- Připojení, autorizace, model a stav baterie každého autorizovaného zařízení.
<device>je model zařízení zapsaný malými písmeny, číslicemi a podtržítky; další zařízení stejného modelu dostanou příponu_2,_3a tak dále.
Často kladené dotazy
Potřebuji Android Studio nebo Android SDK?
Ne. Macro Deck potřebuje jen program adb z Android platform-tools. Klikněte na Stáhnout platform-tools v Nastavení > ADB a Macro Deck stáhne oficiální balíček od Googlu, asi 15 MB, pro vlastní použití. Existující instalace se najde automaticky.
Můžu zařízení ovládat přes Wi-Fi?
Ano. V zařízení zapněte bezdrátové ladění a zadejte jeho IP adresu a port v části Připojit přes Wi-Fi v Nastavení > ADB. Macro Deck zařízení sám nepáruje: na Androidu 11 a novějším zařízení s tímto počítačem nejdřív spárujte, nebo ho přes USB přepněte na ladění po síti pomocí adb tcpip. Jinak zařízení připojení odmítne.
Proč akce selže s hlášením, že nebylo nalezeno žádné zařízení?
Když pole Zařízení necháte prázdné, akce použije výchozí zařízení. Pokud jste žádné nezvolili a je připojeno víc zařízení, výchozí zařízení neexistuje, takže vyberte zařízení v akci nebo klikněte na Nastavit jako výchozí v Nastavení > ADB. Zkontrolujte také, že zařízení ukazuje Připraveno, a ne Neautorizováno.
Existuje samostatná akce pro uzamčení?
Ne. Android nemá samostatný příkaz pro uzamčení. Uspat / uzamknout obrazovku vypne obrazovku, což zařízení uzamkne stejně jako tlačítko napájení.
Ovlivňuje integrace ADB jiné programy, které ADB používají?
Macro Deck používá běžný server ADB, takže ho sdílí s programy jako Android Studio. Restartovat server ADB v Nastavení > ADB na okamžik odpojí i jejich zařízení. Při ukončení Macro Deck nechává server běžet, pokud nezapnete Zastavit server ADB při ukončení Macro Deck.
Proč zařízení ukazuje „Bez oprávnění k přístupu k tomuto zařízení“?
Počítač nemá oprávnění komunikovat se zařízením přes USB. Na Linuxu nainstalujte pravidla udev z platform-tools, na Windows nainstalujte ovladač USB od výrobce zařízení.
Další v kategorii Váš počítač
Systém
Součást Macro DeckOvládejte počítač z decku: aplikace, hlasitost, příkazy, oznámení, uspání a vypnutí.
Klávesnice
Součást Macro DeckMačkejte klávesové zkratky, pište text a spouštějte sekvence kláves na počítači jedním tlačítkem.
Myš
Součást Macro DeckKlikejte, posouvejte kurzor, táhněte a rolujte na počítači jedním tlačítkem.
Steam
Součást Macro DeckSpouštějte a zavírejte hry ze Steamu a zobrazujte na decku, co hrajete, své přátele a knihovnu.