ADB / Android Debug Bridge
Incluida en Macro DeckControla un teléfono o una tablet Android por USB o Wi-Fi: actívalo, inicia aplicaciones, toca, escribe y haz capturas de pantalla.
La pestaña Resumen de la integración ADB / Android Debug Bridge, con un aviso para activar ADB en Configuración
- Activa, bloquea y reinicia un dispositivo Android conectado
- Inicia o fuerza el cierre de aplicaciones y abre enlaces en el dispositivo
- Envía teclas, toques, deslizamientos y texto
- Guarda capturas de la pantalla del dispositivo en una carpeta
- Eventos y variables del dispositivo para la batería, la pantalla y la aplicación en primer plano
La integración ADB controla teléfonos y tablets Android a través de Android Debug Bridge (ADB), la misma herramienta que usan los desarrolladores de Android. Macro Deck localiza el programa adb, ejecuta el servidor ADB y lleva el control de los dispositivos conectados por USB o por Wi-Fi. También puede descargar por ti las platform-tools oficiales de Android.
Cada acción funciona en el dispositivo que elijas en la acción, o en el dispositivo predeterminado si dejas Dispositivo vacío. El dispositivo predeterminado es el que elegiste con Establecer como predeterminado en Configuración > ADB, o el único dispositivo conectado si no elegiste ninguno.
Qué puedes hacer
- Pantalla y energía: activa el dispositivo, apaga la pantalla (así es como Android bloquea el dispositivo) o reinícialo en Android, en recovery o en el bootloader.
- Aplicaciones y enlaces: inicia una aplicación o fuerza su cierre por su nombre de paquete, como
com.spotify.music, y abre un enlace con la aplicación que el dispositivo elija para él. - Entrada: envía una tecla como Home, Back, Volume Up o Media Play Pause, toca un punto de la pantalla, desliza de un punto a otro o escribe texto en el campo que tenga el foco.
- Capturas de pantalla: captura la pantalla como archivo PNG en una carpeta de tu ordenador y, si quieres, escribe la ruta del archivo en una variable.
Algunos ejemplos:
- Un botón que activa una tablet de tu escritorio e inicia tu aplicación de música.
- Un botón que envía Media Play Pause a tu teléfono.
- Una automatización con Dispositivo conectado que abre una página de panel en una tablet en cuanto la conectas.
Estado en directo
La integración informa cuando un dispositivo se conecta, se desconecta, queda autorizado, deja de estar autorizado, pasa a estar sin conexión o vuelve a estar en línea, para que los flujos y los botones puedan reaccionar. Las variables guardan el número de dispositivos conectados y autorizados y, para el dispositivo predeterminado, su modelo, su fabricante, su nivel de batería, si la pantalla está encendida, si se muestra la pantalla de bloqueo y qué aplicación está en primer plano. Cada dispositivo autorizado tiene además sus propias variables, con el nombre de su modelo. Mientras la integración está activada, la batería de cada dispositivo Android también aparece en el widget de batería.
Las acciones básicas (teclas, toques, deslizamientos, texto, aplicaciones, enlaces, reinicios y capturas de pantalla) siguen funcionando mientras Macro Deck está bloqueado, así que un botón con una de ellas también funciona con el ordenador bloqueado.
Qué necesitas
- Macro Deck 3 en Windows, macOS o Linux
- Un dispositivo Android con la depuración por USB activada en sus opciones para desarrolladores
- Un cable USB que transmita datos, o la depuración inalámbrica para conectarse por Wi-Fi
- Las platform-tools de Android (adb); Macro Deck puede descargarlas en Configuración > ADB
- En Linux, permiso para que tu usuario acceda al dispositivo USB, normalmente mediante una regla udev
Configúrala
Paso 1: Activa la integración ADB
En la barra lateral, haz clic en Integraciones y después en ADB / Android Debug Bridge. La integración permanece desactivada hasta que actives el interruptor de arriba a la derecha. Una vez activada, la página muestra ADB está desactivado hasta que actives ADB en el paso siguiente.
Paso 2: Habilita ADB en Macro Deck
Abre Configuración > ADB y activa Habilitar ADB. Si Programa ADB muestra No encontrado, haz clic en Descargar platform-tools. Un Android SDK ya instalado o un
adben tuPATHse detectan automáticamente, y con Ruta del ejecutable puedes indicar otro.Paso 3: Activa la depuración por USB en el dispositivo
En el teléfono o la tablet, abre Ajustes > Información del teléfono y toca Número de compilación siete veces para activar las Opciones para desarrolladores. Después activa Depuración por USB en Ajustes > Opciones para desarrolladores. La ubicación exacta varía un poco según el fabricante.
Paso 4: Conecta y autoriza el dispositivo
Conecta el dispositivo con un cable USB y confirma ¿Permitir depuración por USB? en su pantalla. Marca Permitir siempre desde este ordenador para que no vuelva a preguntar. Después, el dispositivo aparece en Dispositivos, dentro de Configuración > ADB, como Listo. Para conectarte por Wi-Fi, introduce la dirección IP y el puerto del dispositivo en Conectar por Wi-Fi, por ejemplo
192.168.1.20:5555.Paso 5: Elige un dispositivo predeterminado
Si hay más de un dispositivo conectado, haz clic en Establecer como predeterminado junto al que deben usar tus acciones cuando dejes Dispositivo vacío. Si solo hay uno, se usa automáticamente.
Paso 6: Añade una acción de ADB a un botón
En la página Deck, asegúrate de que el deck está desbloqueado (el botón de arriba a la derecha dice Bloquear) y haz clic en un botón. El editor se abre con Pulsación corta seleccionada. Haz clic en + Añadir acción, elige ADB / Android Debug Bridge a la izquierda del cuadro de diálogo Añadir acción y selecciona una acción, por ejemplo Activar dispositivo o Iniciar aplicación. Rellena sus campos, como Paquete para Iniciar aplicación, y deja Dispositivo vacío para usar el dispositivo predeterminado. La categoría solo aparece mientras la integración está activada.
Paso 7: Pulsa el botón
Haz clic en Guardar y pulsa el botón en tu deck. Si no pasa nada, busca un aviso en Integraciones, como No hay dispositivos conectados o un dispositivo que necesita autorización.
Acciones11
Ponlas en un botón o ejecútalas desde un flujo.
- Activar dispositivo
- Activa la pantalla del dispositivo.
- Suspender/bloquear pantalla
- Apaga la pantalla del dispositivo, que es como Android bloquea un dispositivo.
- Iniciar aplicación
- Inicia una aplicación por su nombre de paquete o la pone en primer plano.
- Forzar cierre de aplicación
- Fuerza el cierre de una aplicación por su nombre de paquete.
- Abrir enlace
- Abre un URI en el dispositivo, igual que al tocar un enlace.
- Escribir texto
- Escribe texto en el campo que tiene el foco en el dispositivo.
- Enviar tecla
- Envía un único evento de tecla de Android, como Home, Back, Volume Up o Media Next.
- Tocar
- Toca la pantalla en las coordenadas X e Y indicadas.
- Deslizar
- Desliza por la pantalla de un punto a otro durante el tiempo indicado.
- Reiniciar dispositivo
- Reinicia el dispositivo en modo normal, recovery o bootloader.
- Tomar captura de pantalla
- Captura la pantalla del dispositivo y la guarda como archivo PNG en una carpeta, y si quieres escribe su ruta en una variable.
Disparadores6
Un botón o un flujo puede reaccionar a estos eventos.
- Dispositivo conectado
- Se conectó un dispositivo Android, o Macro Deck lo detectó por primera vez.
- Dispositivo desconectado
- Se desconectó un dispositivo Android, o Macro Deck dejó de detectarlo.
- Dispositivo autorizado
- Se aceptó el aviso de autorización en el dispositivo.
- Dispositivo dejó de estar autorizado
- Un dispositivo antes autorizado necesita que se acepte de nuevo el aviso de autorización.
- Dispositivo pasó a estar en línea
- Un dispositivo autorizado vuelve a estar accesible.
- Dispositivo pasó a estar sin conexión
- Un dispositivo que estaba accesible ya no lo está.
Variables11
Muestra estos valores en botones y widgets, o úsalos en condiciones.
adb_connected_device_count- El número de dispositivos Android conectados.
adb_authorized_device_count- El número de dispositivos en línea y autorizados.
adb_device_connected- Si el dispositivo predeterminado está conectado.
adb_device_authorized- Si el dispositivo predeterminado ha autorizado a este ordenador.
adb_device_model- El modelo del dispositivo predeterminado.
adb_device_manufacturer- El fabricante del dispositivo predeterminado.
adb_device_battery_level- El nivel de batería del dispositivo predeterminado en porcentaje.
adb_device_screen_on- Si la pantalla del dispositivo predeterminado está encendida.
adb_device_locked- Si el dispositivo predeterminado muestra su pantalla de bloqueo.
adb_device_foreground_app- El nombre de paquete de la aplicación en primer plano en el dispositivo predeterminado.
adb_device_<device>_connected,adb_device_<device>_authorized,adb_device_<device>_model,adb_device_<device>_battery_level- Conexión, autorización, modelo y nivel de batería de cada dispositivo autorizado.
<device>es el modelo del dispositivo en minúsculas, dígitos y guiones bajos, con_2,_3, etc. añadidos para más dispositivos del mismo modelo.
Preguntas frecuentes
¿Necesito Android Studio o el Android SDK?
No. Macro Deck solo necesita el programa adb de las platform-tools de Android. Haz clic en Descargar platform-tools en Configuración > ADB y Macro Deck descarga el paquete oficial de Google, de unos 15 MB, para su propio uso. Una instalación existente se detecta automáticamente.
¿Puedo controlar un dispositivo por Wi-Fi?
Sí. Activa la depuración inalámbrica en el dispositivo e introduce su dirección IP y su puerto en Conectar por Wi-Fi, dentro de Configuración > ADB. Macro Deck no vincula dispositivos por sí mismo: en Android 11 y versiones posteriores, vincula antes el dispositivo con este ordenador, o cámbialo a depuración por red mediante USB con adb tcpip. Si no, el dispositivo rechaza la conexión.
¿Por qué falla una acción porque no encuentra ningún dispositivo?
Si dejas Dispositivo vacío, la acción usa el dispositivo predeterminado. Si no elegiste ninguno y hay más de un dispositivo conectado, no hay dispositivo predeterminado, así que elige un dispositivo en la acción o haz clic en Establecer como predeterminado en Configuración > ADB. Comprueba también que el dispositivo muestre Listo y no No autorizado.
¿Hay una acción aparte para bloquear?
No. Android no tiene un comando de bloqueo aparte. Suspender/bloquear pantalla apaga la pantalla, lo que bloquea el dispositivo igual que el botón de encendido.
¿Afecta la integración ADB a otros programas que usan ADB?
Macro Deck usa el servidor ADB normal, así que programas como Android Studio lo comparten. Reiniciar servidor ADB en Configuración > ADB también desconecta brevemente sus dispositivos. Macro Deck deja el servidor en marcha al cerrarse, salvo que actives Detener el servidor ADB al cerrar Macro Deck.
¿Por qué el dispositivo muestra "Sin permiso para acceder a este dispositivo"?
El ordenador no tiene permiso para comunicarse con el dispositivo por USB. En Linux, instala las reglas udev de las platform-tools; en Windows, instala el controlador USB del fabricante del dispositivo.
Más en Tu ordenador
Sistema
Incluida en Macro DeckControla tu ordenador desde tu deck: aplicaciones, volumen, comandos, notificaciones, suspensión y apagado.
Teclado
Incluida en Macro DeckPulsa atajos, escribe texto y ejecuta secuencias de teclas en tu ordenador desde un botón.
Ratón
Incluida en Macro DeckHaz clic, mueve el puntero, arrastra y desplázate en tu ordenador desde un botón.
Steam
Incluida en Macro DeckInicia y cierra juegos de Steam, y muestra en tu deck a qué juegas, tus amigos y tu biblioteca.