ADB / Android Debug Bridge
Inclusa in Macro DeckControlla un telefono o un tablet Android via USB o Wi-Fi: riattivalo, avvia app, tocca, digita e acquisisci screenshot.
La scheda Panoramica dell'integrazione ADB / Android Debug Bridge, con l'avviso di attivare ADB nelle Impostazioni
- Riattiva, blocca e riavvia un dispositivo Android connesso
- Avvia o forza l'arresto di app e apri link sul dispositivo
- Invia tasti, tocchi, scorrimenti e testo
- Salva in una cartella screenshot dello schermo del dispositivo
- Eventi del dispositivo e variabili per batteria, schermo e app in primo piano
L'integrazione ADB controlla telefoni e tablet Android tramite Android Debug Bridge (ADB), lo stesso strumento che usano gli sviluppatori Android. Macro Deck trova il programma adb, esegue il server ADB e tiene traccia dei dispositivi collegati via USB o connessi via Wi-Fi. Può anche scaricare per te i platform-tools ufficiali di Android.
Ogni azione agisce sul dispositivo che scegli nell'azione, oppure sul dispositivo predefinito se lasci vuoto Dispositivo. Il dispositivo predefinito è quello che hai scelto con Imposta come predefinito in Impostazioni > ADB, oppure l'unico dispositivo collegato se non ne hai scelto nessuno.
Cosa puoi fare
- Schermo e alimentazione: riattiva il dispositivo, spegni lo schermo (in questo modo Android blocca il dispositivo) o riavvialo in Android, in recovery o nel bootloader.
- App e link: avvia un'app o forzane l'arresto tramite il nome del pacchetto, come
com.spotify.music, e apri un link con l'app che il dispositivo sceglie. - Input: invia un tasto come Home, Back, Volume Up o Media Play Pause, tocca un punto dello schermo, scorri da un punto a un altro o digita testo nel campo attivo.
- Screenshot: cattura lo schermo come file PNG in una cartella del computer e, se vuoi, scrivi il percorso del file in una variabile.
Alcuni esempi di configurazione:
- Un pulsante che riattiva un tablet sulla scrivania e avvia la tua app musicale.
- Un pulsante che invia Media Play Pause al telefono.
- Un'automazione su Dispositivo connesso che apre una pagina dashboard su un tablet appena lo colleghi.
Stato in tempo reale
L'integrazione segnala quando un dispositivo viene connesso, disconnesso, autorizzato, diventa non autorizzato, passa offline o torna online, così flussi e pulsanti possono reagire. Le variabili contengono il numero di dispositivi connessi e autorizzati e, per il dispositivo predefinito, modello, produttore, livello della batteria, se lo schermo è acceso, se è visibile la schermata di blocco e quale app è in primo piano. Ogni dispositivo autorizzato riceve anche variabili proprie, con il nome del suo modello. Finché l'integrazione è attiva, la batteria di ogni dispositivo Android compare anche nel widget Batteria.
Le azioni di base (tasti, tocchi, scorrimenti, testo, app, link, riavvii e screenshot) continuano a funzionare mentre Macro Deck è bloccato, quindi un pulsante associato a una di esse funziona anche con il computer bloccato.
Cosa ti serve
- Macro Deck 3 su Windows, macOS o Linux
- Un dispositivo Android con il Debug USB attivo nelle Opzioni sviluppatore
- Un cavo USB che trasmetta dati, oppure il debug wireless per una connessione via Wi-Fi
- Android platform-tools (adb); Macro Deck può scaricarli in Impostazioni > ADB
- Su Linux, il permesso per il tuo utente di accedere al dispositivo USB, di solito tramite una regola udev
Configurala
Passaggio 1: Attiva l'integrazione ADB
Nella barra laterale, fai clic su Integrazioni e poi su ADB / Android Debug Bridge. L'integrazione resta disattivata finché non attivi l'interruttore in alto a destra. Una volta attivata, la pagina mostra ADB è disattivato finché non attivi ADB nel passaggio successivo.
Passaggio 2: Attiva ADB in Macro Deck
Apri Impostazioni > ADB e attiva Attiva ADB. Se Programma ADB mostra Non trovato, fai clic su Scarica platform-tools. Un Android SDK già presente o un
adbnel tuoPATHvengono trovati automaticamente, e con Percorso eseguibile puoi indicarne un altro.Passaggio 3: Attiva il Debug USB sul dispositivo
Sul telefono o sul tablet, apri Impostazioni > Info sul telefono e tocca sette volte Numero build per attivare le Opzioni sviluppatore. Poi attiva Debug USB in Impostazioni > Opzioni sviluppatore. La posizione esatta varia un po' da produttore a produttore.
Passaggio 4: Connetti e autorizza il dispositivo
Collega il dispositivo con un cavo USB e conferma Consentire il debug USB? sul suo schermo. Spunta Consenti sempre da questo computer perché non lo chieda più. Il dispositivo compare quindi in Dispositivi in Impostazioni > ADB come Pronto. Per connetterti invece via Wi-Fi, inserisci l'indirizzo IP e la porta del dispositivo in Connetti tramite Wi-Fi, per esempio
192.168.1.20:5555.Passaggio 5: Scegli un dispositivo predefinito
Con più dispositivi collegati, fai clic su Imposta come predefinito accanto a quello che le azioni devono usare quando lasci vuoto Dispositivo. Con un solo dispositivo, viene usato automaticamente.
Passaggio 6: Aggiungi un'azione ADB a un pulsante
Nella pagina Deck, assicurati che il deck sia sbloccato (il pulsante in alto a destra indica Blocca) e fai clic su un pulsante. L'editor si apre con Pressione Breve selezionata. Fai clic su + Aggiungi azione, scegli ADB / Android Debug Bridge a sinistra nella finestra Aggiungi azione e seleziona un'azione, per esempio Riattiva dispositivo o Avvia app. Compila i suoi campi, come Pacchetto per Avvia app, e lascia vuoto Dispositivo per usare il dispositivo predefinito. La categoria compare solo mentre l'integrazione è attiva.
Passaggio 7: Premi il pulsante
Fai clic su Salva e premi il pulsante sul deck. Se non succede nulla, controlla se in Integrazioni c'è un avviso, come Nessun dispositivo connesso o un dispositivo che richiede l'autorizzazione.
Azioni11
Assegnale a un pulsante o eseguile da un flusso.
- Riattiva dispositivo
- Riattiva lo schermo del dispositivo.
- Sospendi / Blocca schermo
- Spegne lo schermo del dispositivo, che è il modo in cui Android blocca un dispositivo.
- Avvia app
- Avvia un'app tramite il nome del pacchetto, oppure la porta in primo piano.
- Forza arresto app
- Forza l'arresto di un'app tramite il nome del pacchetto.
- Apri link
- Apre un URI sul dispositivo, come se toccassi un link.
- Digita testo
- Digita testo nel campo attualmente attivo sul dispositivo.
- Invia tasto
- Invia un singolo evento tasto di Android, come Home, Back, Volume Up o Media Next.
- Tocca
- Tocca lo schermo alle coordinate X e Y indicate.
- Scorri
- Scorre sullo schermo da un punto a un altro in un tempo prestabilito.
- Riavvia dispositivo
- Riavvia il dispositivo in modalità Normale, Recovery o Bootloader.
- Cattura screenshot
- Cattura lo schermo del dispositivo e lo salva come file PNG in una cartella, scrivendo eventualmente il percorso in una variabile.
Trigger6
Un pulsante o un flusso può reagire a questi eventi.
- Dispositivo connesso
- Un dispositivo Android è stato collegato, oppure Macro Deck lo ha rilevato per la prima volta.
- Dispositivo disconnesso
- Un dispositivo Android è stato scollegato, oppure Macro Deck ne ha perso traccia.
- Dispositivo autorizzato
- La richiesta di autorizzazione è stata accettata sul dispositivo.
- Dispositivo diventato non autorizzato
- Un dispositivo autorizzato in precedenza richiede di nuovo l'accettazione della richiesta di autorizzazione.
- Dispositivo tornato online
- Un dispositivo autorizzato è di nuovo raggiungibile.
- Dispositivo passato offline
- Un dispositivo che era raggiungibile non lo è più.
Variabili11
Mostra questi valori su pulsanti e widget o usali nelle condizioni.
adb_connected_device_count- Il numero di dispositivi Android collegati.
adb_authorized_device_count- Il numero di dispositivi online e autorizzati.
adb_device_connected- Indica se il dispositivo predefinito è connesso.
adb_device_authorized- Indica se il dispositivo predefinito ha autorizzato questo computer.
adb_device_model- Il modello del dispositivo predefinito.
adb_device_manufacturer- Il produttore del dispositivo predefinito.
adb_device_battery_level- Il livello della batteria del dispositivo predefinito in percentuale.
adb_device_screen_on- Indica se lo schermo del dispositivo predefinito è acceso.
adb_device_locked- Indica se il dispositivo predefinito mostra la schermata di blocco.
adb_device_foreground_app- Il nome del pacchetto dell'app in primo piano sul dispositivo predefinito.
adb_device_<device>_connected,adb_device_<device>_authorized,adb_device_<device>_model,adb_device_<device>_battery_level- Connessione, autorizzazione, modello e livello della batteria di ogni dispositivo autorizzato.
<device>è il modello del dispositivo in lettere minuscole, cifre e trattini bassi, con_2,_3e così via aggiunti per altri dispositivi dello stesso modello.
Domande frequenti
Mi servono Android Studio o l'Android SDK?
No. A Macro Deck serve solo il programma adb dei platform-tools di Android. Fai clic su Scarica platform-tools in Impostazioni > ADB e Macro Deck scarica da Google il pacchetto ufficiale, circa 15 MB, per il proprio uso. Un'installazione già presente viene trovata automaticamente.
Posso controllare un dispositivo via Wi-Fi?
Sì. Attiva il debug wireless sul dispositivo e inserisci il suo indirizzo IP e la porta in Connetti tramite Wi-Fi in Impostazioni > ADB. Macro Deck non associa i dispositivi da solo: da Android 11 in poi, associa prima il dispositivo a questo computer, oppure passalo al debug di rete tramite USB con adb tcpip. Altrimenti il dispositivo rifiuta la connessione.
Perché un'azione non riesce e non trova nessun dispositivo?
Quando lasci vuoto Dispositivo, l'azione usa il dispositivo predefinito. Se non ne hai scelto nessuno e sono collegati più dispositivi, non c'è un predefinito, quindi scegli un dispositivo nell'azione o fai clic su Imposta come predefinito in Impostazioni > ADB. Controlla anche che il dispositivo mostri Pronto e non Non autorizzato.
Esiste un'azione di blocco separata?
No. Android non ha un comando di blocco separato. Sospendi / Blocca schermo spegne lo schermo, che blocca il dispositivo come fa il tasto di accensione.
L'integrazione ADB influisce su altri programmi che usano ADB?
Macro Deck usa il normale server ADB, quindi programmi come Android Studio lo condividono. Riavvia server ADB in Impostazioni > ADB disconnette per un attimo anche i loro dispositivi. Macro Deck lascia il server in esecuzione quando si chiude, a meno che tu non attivi Arresta il server ADB alla chiusura di Macro Deck.
Perché il dispositivo mostra "Nessun permesso per accedere a questo dispositivo"?
Il computer non ha il permesso di comunicare con il dispositivo via USB. Su Linux, installa le regole udev dei platform-tools; su Windows, installa il driver USB del produttore del dispositivo.
Altro in Il tuo computer
Sistema
Inclusa in Macro DeckControlla il computer dal tuo deck: app, volume, comandi, notifiche, sospensione e spegnimento.
Tastiera
Inclusa in Macro DeckPremi scorciatoie, digita testo ed esegui sequenze di tasti sul tuo computer da un pulsante.
Mouse
Inclusa in Macro DeckFai clic, sposta il puntatore, trascina e scorri sul tuo computer da un pulsante.
Steam
Inclusa in Macro DeckAvvia e chiudi giochi Steam e mostra sul deck a cosa giochi, i tuoi amici e la tua libreria.