Macro Deck Companion
Incluida en Macro DeckControla los teléfonos y tablets que usan la app Companion: brillo, rotación, pantalla y capturas de pantalla.
El cuadro de diálogo Conecta un dispositivo de la integración Macro Deck Companion, que no tiene campos
- Ajusta el brillo de pantalla y la orientación de un dispositivo
- Enciende y apaga la pantalla en Android
- Guarda capturas de pantalla del deck como archivos PNG en tu ordenador
- La batería, la red y la memoria de cada dispositivo como variables
- Disparador Dispositivo listo cuando se conecta un dispositivo
La integración Macro Deck Companion conecta Macro Deck con los teléfonos y tablets que usan la app Macro Deck Companion para Android, iPhone y iPad. Cada dispositivo que se conecta tiene su propia configuración, así que puedes enviar comandos a una tablet concreta y leer lo que informa, junto a todos tus demás dispositivos.
No tienes que introducir nada para configurarla. Abre la app Companion en el dispositivo y conéctalo a tu ordenador. El dispositivo aparece entonces por sí solo en la integración, con su propio nombre.
Qué puedes hacer
Las acciones funcionan en un dispositivo cada vez. Eliges el dispositivo en el campo Dispositivo de cada acción:
- Establecer brillo de pantalla y Establecer orientación (automática, vertical u horizontal) funcionan en Android, iPhone y iPad.
- Vibrar funciona en Android y iPhone.
- Hacer captura de pantalla captura el deck o, en Android, toda la pantalla, y la guarda como archivo PNG en una carpeta de tu ordenador.
- Encender pantalla, Apagar pantalla y Traer al frente funcionan en Android, una vez que los permitas en Control del dispositivo, en los ajustes de la app.
Cada dispositivo informa además de su estado mediante variables: nivel de batería, carga, orientación, brillo de pantalla, modelo, plataforma, versión de la app, si Macro Deck está en primer plano, el tipo y el nombre de la red, y el uso de CPU y memoria. Úsalas en etiquetas, condiciones y automatizaciones como cualquier otra variable.
Ejemplos
- Una tablet que solo sirve de deck: una automatización con Servidor detenido ejecuta Apagar pantalla cuando Macro Deck se cierra, y una automatización con Dispositivo listo ejecuta Encender pantalla cuando la tablet vuelve.
- Dos automatizaciones con Variable cambiada para la variable
system_lockedde la integración Sistema apagan la pantalla de la tablet cuando bloqueas el ordenador y la vuelven a encender cuando lo desbloqueas. - Un evento Programación a las 22:00 ejecuta Establecer brillo de pantalla al 20 %, y otro a las 08:00 lo restablece.
- Una etiqueta en el deck de tu teléfono muestra
companion_<configuration>_battery_level_percentde la tablet de la pared, para que veas cuándo necesita cargarse. - Un botón con Hacer captura de pantalla guarda el deck como archivo PNG, y Guardar ruta en variable pone la ruta del archivo en una variable para la siguiente acción.
Una acción necesita que el dispositivo esté conectado. Si se acaba de conectar, la acción espera unos segundos a que esté listo. Cuando un dispositivo no está conectado, sus variables figuran como no disponibles, salvo companion_<configuration>_is_connected, que vale false.
Qué necesitas
- Macro Deck 3 en tu ordenador
- La app Macro Deck Companion en Android 6 o posterior, o en iOS y iPadOS 15 o posterior
- Una licencia de la app Companion o la prueba gratuita de 7 días
- El dispositivo en la misma red que el ordenador, o conectado por USB
- En Android, los permisos de Control del dispositivo en la app para encender y apagar la pantalla y para Traer al frente
Configúrala
Paso 1: Instala la app Companion
Instala Macro Deck Companion desde Google Play o la App Store en tu teléfono o tablet. Inicia la prueba gratuita de 7 días o compra la licencia.
Paso 2: Conecta el dispositivo a Macro Deck
En Macro Deck, en el ordenador, abre el panel de red con el icono de red de la parte superior derecha. En la app, toca Añadir conexión (en iPhone y iPad, +), elige Escanear código QR y escanea el código del panel. También puedes elegir el ordenador en Encontrados en esta red o introducir su dirección.
Paso 3: Busca el dispositivo en la integración
En la barra lateral, haz clic en Integraciones y después en Macro Deck Companion. En cuanto un dispositivo se conecta, aparece por sí solo en Configuración, en la pestaña Resumen, con su nombre, y el interruptor de arriba a la derecha está activado. Si antes desactivaste la integración, vuelve a activar el interruptor. Añadir configuración abre el cuadro de diálogo Conecta un dispositivo, que no tiene campos y solo explica esto. Con Cambiar nombre cambias el nombre que Macro Deck usa para un dispositivo.
Paso 4: Permite el control del dispositivo en Android
Para encender y apagar la pantalla o traer el deck al frente, abre los ajustes de la app en el dispositivo Android y activa los permisos de Control del dispositivo. Encender pantalla también necesita Conexión en segundo plano y Mostrar sobre otras apps, para que el dispositivo siga conectado mientras su pantalla está apagada.
Paso 5: Añade una acción de Companion 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 Macro Deck Companion a la izquierda del cuadro de diálogo Añadir acción y selecciona una acción, por ejemplo Establecer brillo de pantalla. Elige el dispositivo en Dispositivo y establece el valor.
Paso 6: Pulsa el botón
Haz clic en Guardar y pulsa el botón en cualquiera de tus decks. El dispositivo ejecuta el comando mientras esté conectado a Macro Deck.
Acciones7
Ponlas en un botón o ejecútalas desde un flujo.
- Establecer brillo de pantalla
- Establece el brillo de pantalla de un dispositivo Companion, de 0 a 100 %.
- Establecer orientación
- Fija un dispositivo Companion en vertical u horizontal, o deja que gire automáticamente.
- Vibrar
- Hace vibrar brevemente un dispositivo Companion (Android y iPhone).
- Encender pantalla
- Enciende la pantalla de un dispositivo Companion y muestra este Macro Deck (Android).
- Apagar pantalla
- Apaga la pantalla de un dispositivo Companion (Android).
- Traer al frente
- Muestra en primer plano el deck de este Macro Deck en un dispositivo Companion (Android).
- Hacer captura de pantalla
- Captura el deck o, en Android, toda la pantalla de un dispositivo y la guarda como archivo PNG en una carpeta de tu ordenador.
Disparadores1
Un botón o un flujo puede reaccionar a estos eventos.
- Dispositivo listo
- Se ejecuta cuando una app Companion se ha conectado y puede ejecutar acciones de Companion, si quieres solo para un dispositivo.
Variables15
Muestra estos valores en botones y widgets, o úsalos en condiciones.
companion_<configuration>_is_connected- Si el dispositivo está conectado en este momento.
companion_<configuration>_battery_level_percent- La carga de la batería en porcentaje.
companion_<configuration>_charging- Si el dispositivo se está cargando.
companion_<configuration>_orientation- Si el dispositivo está en vertical u horizontal.
companion_<configuration>_screen_brightness_percent- El brillo de pantalla en porcentaje.
companion_<configuration>_model- El modelo del dispositivo.
companion_<configuration>_platform- El sistema operativo y su versión, por ejemplo
Android 14. companion_<configuration>_app_version- La versión de la app Companion.
companion_<configuration>_in_focus- Si Macro Deck está en primer plano en el dispositivo.
companion_<configuration>_network_type- El tipo de red: Wi-Fi, datos móviles, Ethernet, VPN o ninguna.
companion_<configuration>_network_metered- Si la red es de uso medido.
companion_<configuration>_network_validated- Si la red tiene acceso a Internet.
companion_<configuration>_network_name- El nombre de la red Wi-Fi, en Android con el permiso para el nombre de la red Wi-Fi.
companion_<configuration>_cpu_usage_percent- El uso de CPU en porcentaje, en iOS.
companion_<configuration>_memory_used_percent- La memoria en uso en porcentaje.
Preguntas frecuentes
¿Necesito la app Companion para usar Macro Deck en un teléfono?
No. Cualquier dispositivo con un navegador actual puede usar el cliente web gratuito. Las acciones y variables de esta integración necesitan la app Companion, porque un navegador no puede controlar el propio dispositivo.
¿Por qué fallan Encender pantalla o Apagar pantalla?
Estas acciones solo funcionan en Android, y solo con los permisos de Control del dispositivo en los ajustes de la app. Encender pantalla también necesita Conexión en segundo plano y Mostrar sobre otras apps, para que el dispositivo siga conectado mientras su pantalla está apagada. En iPhone y iPad, una app no puede encender ni apagar la pantalla.
¿Qué pasa cuando un dispositivo no está conectado?
Una acción para ese dispositivo falla con El dispositivo Companion no está conectado. Sus variables figuran como no disponibles y companion_<configuration>_is_connected vale false. Cuando el dispositivo se vuelve a conectar, se ejecuta Dispositivo listo y las variables se actualizan.
¿Puedo usar varios teléfonos y tablets?
Sí. Cada dispositivo que se conecta tiene su propia configuración, con sus propias variables. En cada acción eliges el dispositivo en Dispositivo.
¿Dónde se guardan las capturas de pantalla?
En el ordenador en el que se ejecuta Macro Deck, en la Carpeta que elijas en la acción, como companion-screenshot-<date>-<time>.png. Una captura del deck necesita que el deck esté en la pantalla del dispositivo. Una captura de toda la pantalla solo funciona en Android, después de permitirla en el dispositivo.
¿Pueden los complementos usar también mis dispositivos Companion?
Solo mientras Permitir que los complementos usen dispositivos Companion esté activado en Acceso de complementos, dentro de Configuración > App Companion. Permanece desactivado hasta que lo actives. No afecta a las acciones, variables y disparador propios de esta integración.
Más en Macro Deck
Macro Deck Delegate
Incluida en Macro DeckEjecuta scripts en otro PC con Macro Deck y usa las variables que comparte.
Scripts
Incluida en Macro DeckCrea una vez un conjunto de acciones como script y ejecútalo desde cualquier botón, automatización u otro script.
Variables
Incluida en Macro DeckCambia tus variables desde botones y automatizaciones, y escribe cualquier variable en un archivo.