ADB / Android Debug Bridge
Incluída no Macro DeckControle um celular ou tablet Android via USB ou Wi-Fi: acorde o aparelho, inicie apps, toque, digite e capture a tela.
A aba Visão geral da integração ADB / Android Debug Bridge, com um aviso para ativar o ADB nas Configurações
- Acorde, bloqueie e reinicie um dispositivo Android conectado
- Inicie ou force o encerramento de apps e abra links no dispositivo
- Envie teclas, toques, gestos de deslizar e texto
- Salve capturas da tela do dispositivo em uma pasta
- Eventos e variáveis do dispositivo para bateria, tela e app em primeiro plano
A integração ADB controla celulares e tablets Android pelo Android Debug Bridge (ADB), a mesma ferramenta que os desenvolvedores Android usam. O Macro Deck encontra o programa adb, executa o servidor ADB e acompanha os dispositivos ligados por USB ou conectados via Wi-Fi. Ele também pode baixar para você as platform-tools oficiais do Android.
Cada ação funciona no dispositivo escolhido na própria ação ou no dispositivo padrão quando Dispositivo fica vazio. O dispositivo padrão é aquele escolhido com Definir como padrão em Configurações > ADB ou, se nenhum foi escolhido, o único dispositivo conectado.
O que dá para fazer
- Tela e energia: acorde o dispositivo, desligue a tela (é assim que o Android bloqueia o aparelho) ou reinicie no Android, no recovery ou no bootloader.
- Apps e links: inicie um app ou force o encerramento dele pelo nome do pacote, como
com.spotify.music, e abra um link com o app que o dispositivo escolher para ele. - Entrada: envie uma tecla como Home, Back, Volume Up ou Media Play Pause, toque em um ponto da tela, deslize de um ponto a outro ou digite texto no campo em foco.
- Capturas de tela: capture a tela como arquivo PNG em uma pasta do computador e, se quiser, grave o caminho do arquivo em uma variável.
Alguns exemplos de uso:
- Um botão que acorda um tablet na mesa e inicia o app de música.
- Um botão que envia Media Play Pause para o celular.
- Uma automação em Dispositivo conectado que abre uma página de painel em um tablet assim que ele é conectado.
Status ao vivo
A integração informa quando um dispositivo é conectado, desconectado, autorizado, perde a autorização, fica offline ou volta a ficar online, para que fluxos e botões possam reagir. As variáveis guardam o número de dispositivos conectados e autorizados e, para o dispositivo padrão, o modelo, o fabricante, o nível da bateria, se a tela está ligada, se a tela de bloqueio está sendo exibida e qual app está em primeiro plano. Cada dispositivo autorizado também recebe variáveis próprias, com o nome do modelo. Enquanto a integração estiver ativada, a bateria de cada dispositivo Android também aparece no widget Bateria.
As ações básicas (teclas, toques, gestos de deslizar, texto, apps, links, reinicializações e capturas de tela) continuam funcionando com o Macro Deck bloqueado, então um botão com uma delas funciona mesmo com o computador bloqueado.
O que é necessário
- Macro Deck 3 no Windows, macOS ou Linux
- Um dispositivo Android com a depuração USB ativada nas Opções do desenvolvedor
- Um cabo USB que transmita dados, ou a depuração sem fio para conectar via Wi-Fi
- Android platform-tools (adb); o Macro Deck pode baixá-las em Configurações > ADB
- No Linux, permissão para o seu usuário acessar o dispositivo USB, normalmente por uma regra udev
Configuração
Passo 1: Ative a integração ADB
Na barra lateral, clique em Integrações e depois em ADB / Android Debug Bridge. A integração fica desativada até você ativar a chave no canto superior direito. Depois de ativada, a página mostra O ADB está desativado até você ativar o ADB no próximo passo.
Passo 2: Ative o ADB no Macro Deck
Abra Configurações > ADB e ative Ativar ADB. Se Programa ADB mostrar Não encontrado, clique em Baixar platform-tools. Um Android SDK já instalado ou um
adbno seuPATHé encontrado automaticamente, e Caminho do executável permite indicar outro.Passo 3: Ative a depuração USB no dispositivo
No celular ou tablet, abra Configurações > Sobre o telefone e toque sete vezes em Número da versão para ativar as Opções do desenvolvedor. Depois ative a Depuração USB em Configurações > Opções do desenvolvedor. O local exato varia um pouco entre fabricantes.
Passo 4: Conecte e autorize o dispositivo
Conecte o dispositivo com um cabo USB e confirme Permitir a depuração USB? na tela dele. Marque Sempre permitir a partir deste computador para que ele não pergunte de novo. O dispositivo aparece então em Dispositivos em Configurações > ADB como Pronto. Para conectar via Wi-Fi em vez de USB, informe o endereço IP e a porta do dispositivo em Conectar via Wi-Fi, por exemplo
192.168.1.20:5555.Passo 5: Escolha um dispositivo padrão
Com mais de um dispositivo conectado, clique em Definir como padrão ao lado daquele que as ações devem usar quando você deixar Dispositivo vazio. Com um único dispositivo, ele é usado automaticamente.
Passo 6: Adicione uma ação ADB a um botão
Na página Deck, confira se o deck está desbloqueado (o botão no canto superior direito mostra Bloquear) e clique em um botão. O editor abre com Toque curto selecionado. Clique em + Adicionar ação, escolha ADB / Android Debug Bridge à esquerda da caixa de diálogo Adicionar ação e selecione uma ação, por exemplo Acordar dispositivo ou Iniciar app. Preencha os campos, como Pacote em Iniciar app, e deixe Dispositivo vazio para usar o dispositivo padrão. A categoria só aparece enquanto a integração estiver ativada.
Passo 7: Pressione o botão
Clique em Salvar e pressione o botão no seu deck. Se nada acontecer, veja se há algum aviso em Integrações, como Nenhum dispositivo conectado ou um dispositivo que precisa de autorização.
Ações11
Coloque estas ações em um botão ou execute-as a partir de um fluxo.
- Acordar dispositivo
- Acorda a tela do dispositivo.
- Suspender / Bloquear tela
- Desliga a tela do dispositivo, que é como o Android bloqueia um aparelho.
- Iniciar app
- Abre um app pelo nome do pacote ou o traz para a frente.
- Forçar encerramento do app
- Força o encerramento de um app pelo nome do pacote.
- Abrir link
- Abre um URI no dispositivo, como se um link fosse tocado.
- Digitar texto
- Digita texto no campo em foco no dispositivo.
- Enviar tecla
- Envia um único evento de tecla do Android, como Home, Back, Volume Up ou Media Next.
- Tocar
- Toca na tela nas coordenadas X e Y informadas.
- Deslizar
- Desliza na tela de um ponto a outro durante um tempo definido.
- Reiniciar dispositivo
- Reinicia o dispositivo no modo Normal, Recuperação ou Bootloader.
- Capturar tela
- Captura a tela do dispositivo e a salva como arquivo PNG em uma pasta, com a opção de gravar o caminho em uma variável.
Gatilhos6
Um botão ou fluxo pode reagir a estes eventos.
- Dispositivo conectado
- Um dispositivo Android foi conectado ou o Macro Deck o detectou pela primeira vez.
- Dispositivo desconectado
- Um dispositivo Android foi desconectado ou o Macro Deck perdeu o contato com ele.
- Dispositivo autorizado
- A solicitação de autorização foi aceita no dispositivo.
- Dispositivo perdeu a autorização
- Um dispositivo que já estava autorizado precisa que a solicitação de autorização seja aceita de novo.
- Dispositivo ficou online
- Um dispositivo autorizado voltou a ficar acessível.
- Dispositivo ficou offline
- Um dispositivo que estava acessível não pode mais ser alcançado.
Variáveis11
Mostre estes valores em botões e widgets ou use-os em condições.
adb_connected_device_count- O número de dispositivos Android conectados.
adb_authorized_device_count- O número de dispositivos online e autorizados.
adb_device_connected- Se o dispositivo padrão está conectado.
adb_device_authorized- Se o dispositivo padrão autorizou este computador.
adb_device_model- O modelo do dispositivo padrão.
adb_device_manufacturer- O fabricante do dispositivo padrão.
adb_device_battery_level- O nível da bateria do dispositivo padrão em porcentagem.
adb_device_screen_on- Se a tela do dispositivo padrão está ligada.
adb_device_locked- Se o dispositivo padrão está exibindo a tela de bloqueio.
adb_device_foreground_app- O nome do pacote do app em primeiro plano no dispositivo padrão.
adb_device_<device>_connected,adb_device_<device>_authorized,adb_device_<device>_model,adb_device_<device>_battery_level- Conectado, autorizado, modelo e nível da bateria de cada dispositivo autorizado.
<device>é o modelo do dispositivo em letras minúsculas, dígitos e sublinhados, com_2,_3e assim por diante para outros dispositivos do mesmo modelo.
Perguntas frequentes
Preciso do Android Studio ou do Android SDK?
Não. O Macro Deck só precisa do programa adb das Android platform-tools. Clique em Baixar platform-tools em Configurações > ADB e o Macro Deck baixa o pacote oficial do Google, com cerca de 15 MB, para uso próprio. Uma instalação já existente é encontrada automaticamente.
Posso controlar um dispositivo via Wi-Fi?
Sim. Ative a depuração sem fio no dispositivo e informe o endereço IP e a porta dele em Conectar via Wi-Fi em Configurações > ADB. O Macro Deck não faz o pareamento sozinho: no Android 11 e posteriores, pareie antes o dispositivo com este computador ou mude-o para a depuração pela rede via USB com adb tcpip. Caso contrário, o dispositivo recusa a conexão.
Por que uma ação falha dizendo que nenhum dispositivo foi encontrado?
Quando você deixa Dispositivo vazio, a ação usa o dispositivo padrão. Se nenhum foi escolhido e há mais de um dispositivo conectado, não existe padrão; então escolha um dispositivo na ação ou clique em Definir como padrão em Configurações > ADB. Confira também se o dispositivo aparece como Pronto e não como Não autorizado.
Existe uma ação separada para bloquear?
Não. O Android não tem um comando de bloqueio separado. Suspender / Bloquear tela desliga a tela, o que bloqueia o dispositivo do mesmo jeito que o botão liga/desliga.
A integração ADB afeta outros programas que usam ADB?
O Macro Deck usa o servidor ADB normal, então programas como o Android Studio o compartilham. Reiniciar servidor ADB em Configurações > ADB também desconecta rapidamente os dispositivos desses programas. O Macro Deck deixa o servidor em execução ao fechar, a menos que Parar o servidor ADB ao fechar o Macro Deck esteja ativado.
Por que o dispositivo mostra "Sem permissão para acessar este dispositivo"?
O computador não tem permissão para se comunicar com o dispositivo via USB. No Linux, instale as regras udev das platform-tools; no Windows, instale o driver USB do fabricante do dispositivo.
Mais em Seu computador
Sistema
Incluída no Macro DeckControle o computador pelo seu deck: apps, volume, comandos, notificações, suspensão e desligamento.
Teclado
Incluída no Macro DeckPressione atalhos, digite texto e execute sequências de teclas no computador a partir de um botão.
Mouse
Incluída no Macro DeckClique, mova o ponteiro, arraste e role no computador a partir de um botão.
Steam
Incluída no Macro DeckInicie e feche jogos da Steam e mostre no deck o que você está jogando, seus amigos e sua biblioteca.