AutoHotkey
Incluida en Macro DeckGuarda tus scripts de AutoHotkey v2 en Macro Deck, ejecútalos y detenlos desde un botón y deja que lean y establezcan variables.
La pestaña Scripts de la integración AutoHotkey con una lista de scripts y uno abierto en el editor
- Escribe, comprueba y prueba scripts de AutoHotkey v2 en Macro Deck
- Ejecuta scripts, archivos .ahk o código en línea desde un botón
- Inicia, detén y alterna scripts que siguen en ejecución
- Pasa valores de forma segura como parámetros
- Los scripts pueden leer y establecer variables y mostrar notificaciones
La integración AutoHotkey ejecuta scripts de AutoHotkey v2 desde tus botones y automatizaciones: enviar teclas a una ventana en segundo plano, organizar ventanas, atajos propios de cada app y todo lo demás que AutoHotkey puede hacer. Solo está disponible en Windows y permanece desactivada hasta que la actives. Macro Deck no incluye AutoHotkey: encuentra el AutoHotkey v2 que hayas instalado o uno portable que elijas. AutoHotkey v1 no es compatible.
Qué puedes hacer
- Guarda tus scripts en la pestaña Scripts de la integración, edítalos con resaltado de sintaxis, usa Comprobar sintaxis y ejecútalos ahí mismo. Última ejecución muestra cómo fue la ejecución más reciente: su resultado, los errores con su línea y la salida del script.
- Ejecuta un script de la biblioteca con Ejecutar script de AutoHotkey, un archivo
.ahkdesde donde está guardado con Ejecutar archivo de AutoHotkey, o código escrito en la propia acción con Ejecutar código de AutoHotkey en línea. - Inicia scripts con atajos o temporizadores junto con Macro Deck, e inícialos y detenlos con Alternar script de AutoHotkey. El botón muestra En ejecución o No se está ejecutando.
- Pasa valores a un script como Parámetros. Macro Deck nunca inserta valores en el texto de un script, así que un valor no puede romper ni cambiar tu código. El script los lee como
MacroDeck.Params["name"]. - Deja que un script responda mediante las funciones auxiliares de Macro Deck:
MacroDeck.GetVaryMacroDeck.SetVarleen y establecen variables,MacroDeck.Notifymuestra una notificación yMacroDeck.SetResultcomunica un resultado a la acción. - Inicia una automatización cuando un script se inicia, termina o falla.
Algunos ejemplos:
- Un botón Alternar script de AutoHotkey para un script con tus atajos para juegos, con su propio aspecto para En ejecución y No se está ejecutando.
- Un botón que ejecuta un script con el parámetro
volumeestablecido en{{ vars.volume }}, y el script llama aSoundSetVolume MacroDeck.Params["volume"]. - Una automatización con Script de AutoHotkey fallido que muestra
{{ event.reason }}en un botón.
Cómo se ejecutan los scripts
AutoHotkey nunca muestra sus cuadros de diálogo de error para los scripts que ejecuta Macro Deck: los errores de carga y de ejecución aparecen en Última ejecución y hacen fallar una acción que espera. A un script que se detiene primero se le pide que se cierre, para que se ejecute su rutina OnExit, y se finaliza tras el Margen de detención en segundos. Detener y Alternar solo afectan a los scripts que inició Macro Deck. Cuando Macro Deck se cierra o desactivas la integración, detiene todos los scripts de AutoHotkey que inició.
Al migrar desde Macro Deck 2, los botones del complemento AutoHotkey de jbcarreon123 que ejecutan scripts de AutoHotkey v2 pasan a usar estas acciones.
Qué necesitas
- Windows.
- AutoHotkey v2, instalado o portable. Macro Deck no lo incluye.
Configúrala
Paso 1: Instala AutoHotkey v2
Descarga AutoHotkey v2 de autohotkey.com e instálalo. Macro Deck lo encuentra donde lo dejó el instalador.
Paso 2: Activa la integración
En Macro Deck, haz clic en Integraciones en la barra lateral, después en AutoHotkey, y activa el interruptor de arriba a la derecha. Si Macro Deck no encuentra AutoHotkey v2, la página muestra No se encontró AutoHotkey: instálalo y haz clic en Volver a comprobar.
Paso 3: Comprueba la configuración de AutoHotkey
En la pestaña Resumen, haz clic en Configurar en la sección Configuración. Configuración de AutoHotkey muestra el AutoHotkey en uso y su versión. Para un AutoHotkey portable, establece Ejecutable de AutoHotkey en Elegir el ejecutable y elige su
AutoHotkey64.execomo Ejecutable. Haz clic en Continuar.Paso 4: Escribe un script
Abre la pestaña Scripts y haz clic en + junto al título de la lista. Introduce un nombre, haz clic en Crear script y escribe el script en el editor, por ejemplo
MsgBox "Hello from Macro Deck". Haz clic en Guardar y luego en Ejecutar para probarlo.Paso 5: Añade una acción a un botón
En la página Deck, haz clic en el botón que quieras usar. El deck tiene que estar desbloqueado: lo está cuando el botón de arriba a la derecha dice Bloquear. El editor se abre con Pulsación corta seleccionada. Haz clic en + Añadir acción, selecciona AutoHotkey a la izquierda del cuadro de diálogo Añadir acción y elige Ejecutar script de AutoHotkey. Elige tu script como Script de AutoHotkey y haz clic en Guardar.
Paso 6: Pulsa el botón
Pulsa el botón en tu deck. El script se ejecuta, y Última ejecución en la pestaña Scripts muestra cómo fue.
Acciones7
Ponlas en un botón o ejecútalas desde un flujo.
- Ejecutar script de AutoHotkey
- Ejecuta un script de la pestaña Scripts con parámetros y puede esperar a que termine.
- Ejecutar archivo de AutoHotkey
- Ejecuta un archivo
.ahkdesde donde está guardado en tu ordenador, con argumentos enA_Argsy parámetros. - Ejecutar código de AutoHotkey en línea
- Ejecuta código de AutoHotkey v2 escrito en la propia acción.
- Detener script de AutoHotkey
- Detiene un script o archivo que inició Macro Deck: todas sus instancias o solo la más reciente.
- Reiniciar script de AutoHotkey
- Detiene un script o archivo y lo vuelve a iniciar con nuevos parámetros, o lo inicia si no se está ejecutando.
- Alternar script de AutoHotkey
- Inicia un script o archivo cuando Macro Deck no lo está ejecutando y lo detiene cuando sí. Muestra En ejecución o No se está ejecutando en el botón.
- Abrir Window Spy
- Abre el Window Spy de AutoHotkey para consultar títulos, clases y controles de ventanas.
Disparadores3
Un botón o un flujo puede reaccionar a estos eventos.
- Script de AutoHotkey iniciado
- Un script que inició Macro Deck se ha cargado y se está ejecutando.
- Script de AutoHotkey terminado
- Uno de esos scripts ha terminado, con su código de salida y el tiempo que estuvo en ejecución.
- Script de AutoHotkey fallido
- Un script no se pudo iniciar o cargar, informó de un error o no terminó a tiempo.
Variables4
Muestra estos valores en botones y widgets, o úsalos en condiciones.
autohotkey_installed,autohotkey_version- Si Macro Deck encontró un AutoHotkey v2 que funciona, y su versión.
autohotkey_running_scripts- Cuántos scripts de AutoHotkey ejecuta Macro Deck en este momento.
autohotkey_last_script,autohotkey_last_exit_code,autohotkey_last_result,autohotkey_last_error- El último script que terminó o falló, su código de salida, el resultado que comunicó con
MacroDeck.SetResulty por qué falló, si falló. autohotkey_script_<name>_running- Si un script de la biblioteca se está ejecutando, una variable por script. El nombre se mantiene aunque cambies el nombre del script.
Preguntas frecuentes
¿Funciona con scripts de AutoHotkey v1?
No. Macro Deck solo es compatible con AutoHotkey v2, y el código escrito para AutoHotkey v1 no se carga en v2. Comprobar sintaxis en la pestaña Scripts muestra la línea del primer error.
¿Cómo paso un valor de Macro Deck a mi script?
Añádelo como parámetro en la acción, por ejemplo volume con el valor {{ vars.volume }}, y léelo en el script como MacroDeck.Params["volume"]. Los valores siempre llegan como texto, exactamente como se introdujeron. Un script también puede leer una variable en cualquier momento con MacroDeck.GetVar("name").
¿Por qué mi script no envía teclas a un juego o a una herramienta?
Macro Deck ejecuta los scripts sin privilegios de administrador, y Windows no les permite enviar teclas ni clics a una ventana de un programa que se ejecuta como administrador.
¿Qué pasa con mis scripts cuando se cierra Macro Deck?
Macro Deck detiene todos los scripts de AutoHotkey que inició cuando se cierra o cuando desactivas la integración. Activa Iniciar al iniciar Macro Deck en la Configuración de un script para que se ejecute siempre que Macro Deck esté en marcha. Los programas que abrió un script siguen abiertos.
¿Puedo seguir usando mis archivos .ahk?
Sí. Ejecutar archivo de AutoHotkey ejecuta un archivo desde donde está guardado, así que A_ScriptDir es su carpeta. También puedes importar un archivo a la biblioteca en la pestaña Scripts.
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.
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.
Steam
Incluida en Macro DeckInicia y cierra juegos de Steam, y muestra en tu deck a qué juegas, tus amigos y tu biblioteca.