AutoHotkey
Incluída no Macro DeckMantenha os scripts AutoHotkey v2 no Macro Deck, inicie e pare cada um a partir de um botão e deixe que leiam e definam variáveis.
A aba Scripts da integração AutoHotkey com uma lista de scripts e um deles aberto no editor
- Escreva, verifique e teste scripts AutoHotkey v2 no Macro Deck
- Execute scripts, arquivos .ahk ou código embutido a partir de um botão
- Inicie, pare e alterne scripts que continuam em execução
- Passe valores com segurança como parâmetros
- Os scripts podem ler e definir variáveis e mostrar notificações
A integração AutoHotkey executa scripts AutoHotkey v2 a partir dos seus botões e automações: enviar teclas para uma janela em segundo plano, organizar janelas, atalhos específicos de um app e tudo o mais que o AutoHotkey consegue fazer. Ela está disponível apenas no Windows e fica desativada até ser ativada. O Macro Deck não inclui o AutoHotkey: ele encontra o AutoHotkey v2 instalado no computador, ou uma versão portátil escolhida manualmente. O AutoHotkey v1 não é suportado.
O que dá para fazer
- Mantenha os scripts na aba Scripts da integração, edite-os com realce de sintaxe, use Verificar sintaxe e execute-os ali mesmo. Última execução mostra como foi a execução mais recente: o resultado, os erros com a respectiva linha e a saída do script.
- Execute um script da biblioteca com Executar script AutoHotkey, um arquivo
.ahkno local onde ele está salvo com Executar arquivo AutoHotkey, ou código escrito na própria ação com Executar código AutoHotkey embutido. - Inicie scripts com atalhos ou timers junto com o Macro Deck, e inicie e pare esses scripts com Alternar script AutoHotkey. O botão mostra Em execução ou Não está em execução.
- Passe valores para um script como Parâmetros. O Macro Deck nunca insere valores no texto de um script, então um valor não pode quebrar nem alterar o código. O script lê esses valores como
MacroDeck.Params["name"]. - Deixe um script responder pelo helper do Macro Deck:
MacroDeck.GetVareMacroDeck.SetVarleem e definem variáveis,MacroDeck.Notifymostra uma notificação eMacroDeck.SetResultinforma um resultado para a ação. - Inicie uma automação quando um script é iniciado, encerrado ou falha.
Alguns exemplos de uso:
- Um botão Alternar script AutoHotkey para um script com os seus atalhos de jogo, com uma aparência própria para Em execução e Não está em execução.
- Um botão que executa um script com o parâmetro
volumedefinido como{{ vars.volume }}, e o script chamaSoundSetVolume MacroDeck.Params["volume"]. - Uma automação em Falha no script AutoHotkey que mostra
{{ event.reason }}em um botão.
Como os scripts são executados
O AutoHotkey nunca mostra as suas caixas de diálogo de erro para scripts que o Macro Deck executa: erros de carregamento e de execução aparecem em Última execução e fazem falhar uma ação que aguarda o script. Um script que é parado primeiro recebe um pedido para fechar, para que a rotina OnExit dele seja executada, e é encerrado depois da Tolerância ao parar em segundos. Parar e Alternar só afetam scripts que o Macro Deck iniciou. Quando o Macro Deck é fechado ou a integração é desativada, ele para todos os scripts AutoHotkey que iniciou.
Na migração do Macro Deck 2, os botões do plugin AutoHotkey de jbcarreon123 que executam scripts AutoHotkey v2 passam para estas ações.
O que é necessário
- Windows.
- AutoHotkey v2, instalado ou portátil. O Macro Deck não o inclui.
Configuração
Passo 1: Instale o AutoHotkey v2
Baixe o AutoHotkey v2 em autohotkey.com e instale. O Macro Deck o encontra no local onde o instalador o colocou.
Passo 2: Ative a integração
No Macro Deck, clique em Integrações na barra lateral e depois em AutoHotkey, e ative a chave no canto superior direito. Quando o Macro Deck não encontra o AutoHotkey v2, a página mostra AutoHotkey não encontrado: instale-o e clique em Verificar novamente.
Passo 3: Confira as configurações do AutoHotkey
Na aba Visão geral, clique em Configurar na seção Configuração. Configurações do AutoHotkey mostra o AutoHotkey em uso e a versão dele. Para um AutoHotkey portátil, defina Executável do AutoHotkey como Escolher o executável e selecione o
AutoHotkey64.exedele como Executável. Clique em Continuar.Passo 4: Escreva um script
Abra a aba Scripts e clique em + ao lado do título da lista. Informe um nome, clique em Criar script e escreva o script no editor, por exemplo
MsgBox "Hello from Macro Deck". Clique em Salvar e depois em Executar para testar.Passo 5: Adicione uma ação a um botão
Na página Deck, clique no botão que você quer usar. O deck precisa estar desbloqueado: se o botão no canto superior direito mostra Bloquear, ele está desbloqueado. O editor abre com Toque curto selecionado. Clique em + Adicionar ação, selecione AutoHotkey à esquerda da caixa de diálogo Adicionar ação e escolha Executar script AutoHotkey. Escolha o script em Script AutoHotkey e clique em Salvar.
Passo 6: Pressione o botão
Pressione o botão no deck. O script é executado, e Última execução na aba Scripts mostra como foi.
Ações7
Coloque estas ações em um botão ou execute-as a partir de um fluxo.
- Executar script AutoHotkey
- Executa um script da aba Scripts com parâmetros e pode aguardar até ele terminar.
- Executar arquivo AutoHotkey
- Executa um arquivo
.ahkno local onde ele está salvo no computador, com argumentos emA_Argse parâmetros. - Executar código AutoHotkey embutido
- Executa código AutoHotkey v2 escrito na própria ação.
- Parar script AutoHotkey
- Para um script ou arquivo que o Macro Deck iniciou: todas as instâncias, ou só a mais recente.
- Reiniciar script AutoHotkey
- Para um script ou arquivo e o inicia de novo com novos parâmetros, ou o inicia quando não está em execução.
- Alternar script AutoHotkey
- Inicia um script ou arquivo quando o Macro Deck não o está executando e o para quando está. Mostra Em execução ou Não está em execução no botão.
- Abrir Window Spy
- Abre o Window Spy do AutoHotkey para consultar títulos, classes e controles de janelas.
Gatilhos3
Um botão ou fluxo pode reagir a estes eventos.
- Script AutoHotkey iniciado
- Um script que o Macro Deck iniciou foi carregado e está em execução.
- Script AutoHotkey encerrado
- Um desses scripts terminou, com o código de saída e por quanto tempo foi executado.
- Falha no script AutoHotkey
- Um script não pôde ser iniciado ou carregado, relatou um erro ou não terminou a tempo.
Variáveis4
Mostre estes valores em botões e widgets ou use-os em condições.
autohotkey_installed,autohotkey_version- Se o Macro Deck encontrou um AutoHotkey v2 que funciona, e a versão dele.
autohotkey_running_scripts- Quantos scripts AutoHotkey o Macro Deck está executando no momento.
autohotkey_last_script,autohotkey_last_exit_code,autohotkey_last_result,autohotkey_last_error- O último script que terminou ou falhou, o código de saída dele, o resultado informado com
MacroDeck.SetResulte o motivo da falha, quando houve. autohotkey_script_<name>_running- Se um script da biblioteca está em execução, uma para cada script. O nome continua o mesmo quando o script é renomeado.
Perguntas frequentes
Funciona com scripts do AutoHotkey v1?
Não. O Macro Deck suporta apenas o AutoHotkey v2, e código escrito para o AutoHotkey v1 não carrega no v2. Verificar sintaxe na aba Scripts mostra a linha do primeiro erro.
Como passo um valor do Macro Deck para o meu script?
Adicione-o como parâmetro na ação, por exemplo volume com o valor {{ vars.volume }}, e leia-o no script como MacroDeck.Params["volume"]. Os valores sempre chegam como texto, exatamente como foram digitados. Um script também pode ler uma variável a qualquer momento com MacroDeck.GetVar("name").
Por que o meu script não envia teclas para um jogo ou programa?
O Macro Deck executa scripts sem direitos de administrador, e o Windows não deixa que eles enviem teclas ou cliques para a janela de um programa executado como administrador.
O que acontece com os meus scripts quando o Macro Deck é fechado?
O Macro Deck para todos os scripts AutoHotkey que iniciou quando é fechado ou quando a integração é desativada. Ative Iniciar com o Macro Deck nas Configurações de um script para que ele esteja em execução sempre que o Macro Deck estiver. Programas que um script abriu continuam abertos.
Posso continuar usando os meus arquivos .ahk?
Sim. Executar arquivo AutoHotkey executa um arquivo no local onde ele está salvo, então A_ScriptDir é a pasta dele. Também é possível importar um arquivo para a biblioteca na aba Scripts.
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.
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.
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.