AutoHotkey

AutoHotkey 連携を使うと、ボタンやオートメーションから AutoHotkey v2 のスクリプトを実行できます。バックグラウンドのウィンドウへのキー送信、ウィンドウの整列、アプリ専用のホットキーなど、AutoHotkey でできることなら何でも行えます。Windows 専用で、オンにするまではオフのままです。Macro Deck には AutoHotkey は含まれていません。インストール済みの AutoHotkey v2、または選択したポータブル版を使います。AutoHotkey v1 には対応していません。

できること

• 連携の スクリプト タブでスクリプトを管理し、構文ハイライト付きで編集し、構文をチェック を実行して、その場で実行できます。前回の実行 には、直近の実行の状況、結果、エラーとその行、スクリプトの出力が表示されます。
• ライブラリのスクリプトは AutoHotkey スクリプトを実行 で、保存場所にある .ahk ファイルは AutoHotkey ファイルを実行 で、アクション内に書いたコードは インライン AutoHotkey コードを実行 で実行します。
• ホットキーやタイマーを使うスクリプトを Macro Deck と一緒に起動し、AutoHotkey スクリプトを切り替え で起動と停止を切り替えます。ボタンには 実行中 または 停止中 と表示されます。
• 値は パラメーター としてスクリプトに渡します。Macro Deck が値をスクリプトのテキストに埋め込むことはないため、値によってコードが壊れたり変わったりすることはありません。スクリプトでは MacroDeck.Params["name"] で読み取ります。
• Macro Deck のヘルパーを使って、スクリプトから Macro Deck に情報を返せます。MacroDeck.GetVar と MacroDeck.SetVar は変数を読み取り・設定し、MacroDeck.Notify は通知を表示し、MacroDeck.SetResult はアクションに結果を報告します。
• スクリプトの起動、終了、失敗をきっかけにオートメーションを開始できます。

設定例:

• ゲーム用ホットキーのスクリプトを切り替える AutoHotkey スクリプトを切り替え ボタン。実行中 と 停止中 でそれぞれ見た目を変えます。
• パラメーター volume を {{ vars.volume }} に設定してスクリプトを実行するボタン。スクリプトは SoundSetVolume MacroDeck.Params["volume"] を呼び出します。
• AutoHotkey スクリプトが失敗 をきっかけに、{{ event.reason }} をボタンに表示するオートメーション。

スクリプトの実行の仕組み

Macro Deck が実行するスクリプトでは、AutoHotkey のエラーダイアログは表示されません。読み込みエラーや実行時エラーは 前回の実行 に表示され、完了を待つアクションは失敗します。スクリプトを停止するときは、まず終了を要求するので OnExit ルーチンが実行され、停止の猶予時間（秒） を過ぎると強制終了されます。停止と切り替えのアクションは、Macro Deck が起動したスクリプトだけに作用します。Macro Deck の終了時や連携をオフにしたときは、Macro Deck が起動したすべての AutoHotkey スクリプトが停止します。

Macro Deck 2 から移行すると、jbcarreon123 による AutoHotkey プラグインのうち AutoHotkey v2 スクリプトを実行するボタンは、これらのアクションに移行されます。