AutoHotkey
Incluse avec Macro DeckGardez vos scripts AutoHotkey v2 dans Macro Deck, lancez-les et arrêtez-les depuis un bouton et laissez-les lire et définir des variables.
L'onglet Scripts de l'intégration AutoHotkey avec une liste de scripts et l'un d'eux ouvert dans l'éditeur
- Écrivez, vérifiez et testez des scripts AutoHotkey v2 dans Macro Deck
- Exécutez des scripts, des fichiers .ahk ou du code intégré depuis un bouton
- Lancez et arrêtez des scripts qui restent en cours d'exécution
- Transmettez des valeurs en toute sécurité comme paramètres
- Les scripts peuvent lire et définir des variables et afficher des notifications
L'intégration AutoHotkey exécute des scripts AutoHotkey v2 depuis vos boutons et vos automatisations : envoyer des touches à une fenêtre en arrière-plan, disposer des fenêtres, des raccourcis propres à une application et tout ce qu'AutoHotkey sait faire d'autre. Elle n'est disponible que sous Windows et reste désactivée jusqu'à ce que vous l'activiez. Macro Deck n'inclut pas AutoHotkey : il trouve l'AutoHotkey v2 que vous avez installé, ou une version portable que vous choisissez. AutoHotkey v1 n'est pas pris en charge.
Ce que vous pouvez faire
- Gardez vos scripts dans l'onglet Scripts de l'intégration, modifiez-les avec la coloration syntaxique, utilisez Vérifier la syntaxe et exécutez-les directement à cet endroit. Dernière exécution montre comment s'est passée la dernière exécution : son résultat, les erreurs avec leur ligne et la sortie du script.
- Exécutez un script de la bibliothèque avec Exécuter un script AutoHotkey, un fichier
.ahkà son emplacement avec Exécuter un fichier AutoHotkey, ou du code écrit dans l'action elle-même avec Exécuter du code AutoHotkey intégré. - Lancez des scripts avec des raccourcis ou des minuteurs en même temps que Macro Deck, et lancez-les ou arrêtez-les avec Lancer ou arrêter un script AutoHotkey. Le bouton affiche En cours d'exécution ou Arrêté.
- Transmettez des valeurs à un script comme Paramètres. Macro Deck n'insère jamais de valeurs dans le texte d'un script, si bien qu'une valeur ne peut ni casser ni modifier votre code. Le script les lit avec
MacroDeck.Params["name"]. - Laissez un script répondre grâce aux fonctions d'aide de Macro Deck :
MacroDeck.GetVaretMacroDeck.SetVarlisent et définissent des variables,MacroDeck.Notifyaffiche une notification etMacroDeck.SetResultrenvoie un résultat à l'action. - Déclenchez une automatisation quand un script démarre, se termine ou échoue.
Quelques exemples de configuration :
- Un bouton Lancer ou arrêter un script AutoHotkey pour un script contenant vos raccourcis de jeu, avec sa propre apparence pour En cours d'exécution et Arrêté.
- Un bouton qui exécute un script avec le paramètre
volumedéfini sur{{ vars.volume }}, et le script appelleSoundSetVolume MacroDeck.Params["volume"]. - Une automatisation sur Échec du script AutoHotkey qui affiche
{{ event.reason }}sur un bouton.
Comment les scripts s'exécutent
AutoHotkey n'affiche jamais ses boîtes de dialogue d'erreur pour les scripts que Macro Deck exécute : les erreurs de chargement et d'exécution apparaissent sous Dernière exécution et font échouer une action qui attend. Un script arrêté est d'abord invité à se fermer, pour que sa routine OnExit s'exécute, puis il est terminé après le Délai de grâce à l'arrêt en secondes. Arrêter un script AutoHotkey et Lancer ou arrêter un script AutoHotkey n'agissent que sur les scripts lancés par Macro Deck. Quand Macro Deck se ferme ou que vous désactivez l'intégration, il arrête tous les scripts AutoHotkey qu'il a lancés.
Lors de la migration depuis Macro Deck 2, les boutons de l'extension AutoHotkey de jbcarreon123 qui exécutent des scripts AutoHotkey v2 passent à ces actions.
Ce qu'il vous faut
- Windows.
- AutoHotkey v2, installé ou portable. Macro Deck ne l'inclut pas.
Configuration
Étape 1: Installez AutoHotkey v2
Téléchargez AutoHotkey v2 sur autohotkey.com et installez-le. Macro Deck le trouve là où le programme d'installation l'a placé.
Étape 2: Activez l'intégration
Dans Macro Deck, cliquez sur Intégrations dans la barre latérale, puis sur AutoHotkey, et activez l'interrupteur en haut à droite. Si Macro Deck ne trouve pas AutoHotkey v2, la page affiche AutoHotkey introuvable : installez-le et cliquez sur Vérifier à nouveau.
Étape 3: Vérifiez les paramètres d'AutoHotkey
Dans l'onglet Aperçu, cliquez sur Configurer dans la section Configuration. Paramètres d'AutoHotkey affiche l'AutoHotkey utilisé et sa version. Pour un AutoHotkey portable, réglez Exécutable AutoHotkey sur Choisir l'exécutable et choisissez son
AutoHotkey64.execomme Exécutable. Cliquez sur Continuer.Étape 4: Écrivez un script
Ouvrez l'onglet Scripts et cliquez sur + à côté du titre de la liste. Saisissez un nom, cliquez sur Créer un script, puis écrivez le script dans l'éditeur, par exemple
MsgBox "Hello from Macro Deck". Cliquez sur Enregistrer, puis sur Exécuter pour l'essayer.Étape 5: Ajoutez une action à un bouton
Sur la page Deck, cliquez sur le bouton que vous voulez utiliser. Le deck doit être déverrouillé : c'est le cas lorsque le bouton en haut à droite indique Verrouiller. L'éditeur s'ouvre avec Appui court sélectionné. Cliquez sur + Ajouter une action, sélectionnez AutoHotkey à gauche de la boîte de dialogue Ajouter une action et choisissez Exécuter un script AutoHotkey. Choisissez votre script comme Script AutoHotkey, puis cliquez sur Enregistrer.
Étape 6: Appuyez sur le bouton
Appuyez sur le bouton de votre deck. Le script s'exécute, et Dernière exécution dans l'onglet Scripts montre comment cela s'est passé.
Actions7
Placez-les sur un bouton ou exécutez-les depuis un flux.
- Exécuter un script AutoHotkey
- Exécute un script de l'onglet Scripts avec des paramètres et peut attendre qu'il se termine.
- Exécuter un fichier AutoHotkey
- Exécute un fichier
.ahkà son emplacement sur votre ordinateur, avec des arguments dansA_Argset des paramètres. - Exécuter du code AutoHotkey intégré
- Exécute du code AutoHotkey v2 écrit dans l'action elle-même.
- Arrêter un script AutoHotkey
- Arrête un script ou un fichier lancé par Macro Deck : toutes ses instances, ou seulement la plus récente.
- Redémarrer un script AutoHotkey
- Arrête un script ou un fichier et le relance avec de nouveaux paramètres, ou le lance s'il n'est pas en cours d'exécution.
- Lancer ou arrêter un script AutoHotkey
- Lance un script ou un fichier quand Macro Deck ne l'exécute pas et l'arrête quand il l'exécute. Affiche En cours d'exécution ou Arrêté sur le bouton.
- Ouvrir Window Spy
- Ouvre le Window Spy d'AutoHotkey pour consulter les titres, les classes et les contrôles des fenêtres.
Déclencheurs3
Un bouton ou un flux peut réagir à ces événements.
- Script AutoHotkey lancé
- Un script lancé par Macro Deck est chargé et s'exécute.
- Script AutoHotkey terminé
- Un tel script s'est terminé, avec son code de sortie et sa durée d'exécution.
- Échec du script AutoHotkey
- Un script n'a pas pu être lancé ou chargé, a signalé une erreur ou ne s'est pas terminé à temps.
Variables4
Affichez ces valeurs sur des boutons et des widgets, ou utilisez-les dans des conditions.
autohotkey_installed,autohotkey_version- Indique si Macro Deck a trouvé un AutoHotkey v2 fonctionnel, et sa version.
autohotkey_running_scripts- Le nombre de scripts AutoHotkey que Macro Deck exécute en ce moment.
autohotkey_last_script,autohotkey_last_exit_code,autohotkey_last_result,autohotkey_last_error- Le dernier script terminé ou en échec, son code de sortie, le résultat qu'il a renvoyé avec
MacroDeck.SetResultet la raison de l'échec, le cas échéant. autohotkey_script_<name>_running- Indique si un script de la bibliothèque est en cours d'exécution, une variable par script. Le nom reste le même quand vous renommez le script.
Questions fréquentes
Est-ce que cela fonctionne avec des scripts AutoHotkey v1 ?
Non. Macro Deck ne prend en charge qu'AutoHotkey v2, et le code écrit pour AutoHotkey v1 ne se charge pas dans v2. Vérifier la syntaxe dans l'onglet Scripts indique la ligne de la première erreur.
Comment transmettre une valeur de Macro Deck à mon script ?
Ajoutez-la comme paramètre dans l'action, par exemple volume avec la valeur {{ vars.volume }}, et lisez-la dans le script avec MacroDeck.Params["volume"]. Les valeurs arrivent toujours sous forme de texte, exactement telles qu'elles ont été saisies. Un script peut aussi lire une variable à tout moment avec MacroDeck.GetVar("name").
Pourquoi mon script n'envoie-t-il pas de touches à un jeu ou à un outil ?
Macro Deck exécute les scripts sans droits d'administrateur, et Windows ne les laisse pas envoyer de touches ni de clics à une fenêtre d'un programme exécuté en tant qu'administrateur.
Que deviennent mes scripts quand Macro Deck se ferme ?
Macro Deck arrête tous les scripts AutoHotkey qu'il a lancés quand il se ferme ou quand vous désactivez l'intégration. Activez Lancer au démarrage de Macro Deck dans les Paramètres d'un script pour qu'il tourne dès que Macro Deck tourne. Les programmes ouverts par un script restent ouverts.
Puis-je continuer à utiliser mes fichiers .ahk ?
Oui. Exécuter un fichier AutoHotkey exécute un fichier à son emplacement, donc A_ScriptDir est son dossier. Vous pouvez aussi importer un fichier dans la bibliothèque depuis l'onglet Scripts.
Plus dans Votre ordinateur
Système
Incluse avec Macro DeckPilotez votre ordinateur depuis votre deck : applications, volume, commandes, notifications, veille et arrêt.
Clavier
Incluse avec Macro DeckDéclenchez des raccourcis, saisissez du texte et exécutez des séquences de touches sur votre ordinateur depuis un bouton.
Souris
Incluse avec Macro DeckCliquez, déplacez le pointeur, faites glisser et défilez sur votre ordinateur depuis un bouton.
ADB / Android Debug Bridge
Incluse avec Macro DeckPilotez un téléphone ou une tablette Android en USB ou en Wi-Fi : réveillez-le, lancez des applications, touchez l'écran, saisissez du texte et faites des captures d'écran.
Steam
Incluse avec Macro DeckLancez et fermez des jeux Steam, et affichez sur votre deck ce à quoi vous jouez, vos amis et votre bibliothèque.