AutoHotkey

AutoHotkey 연동은 버튼과 자동화에서 AutoHotkey v2 스크립트를 실행합니다. 백그라운드 창에 키 보내기, 창 정렬, 앱별 단축키 등 AutoHotkey로 할 수 있는 모든 일에 쓸 수 있습니다. Windows에서만 사용할 수 있으며, 직접 켜기 전까지는 꺼져 있습니다. Macro Deck에는 AutoHotkey가 포함되어 있지 않으며, 설치된 AutoHotkey v2를 찾거나 직접 선택한 포터블 버전을 사용합니다. AutoHotkey v1은 지원하지 않습니다.

할 수 있는 일

• 연동의 스크립트 탭에 스크립트를 보관하고, 구문 강조가 있는 편집기에서 수정하고, 그 자리에서 구문 검사와 실행. 마지막 실행에는 최근 실행이 어떻게 끝났는지, 그 결과, 줄 번호가 포함된 오류, 스크립트 출력이 표시됩니다.
• AutoHotkey 스크립트 실행으로 라이브러리의 스크립트를, AutoHotkey 파일 실행으로 저장된 위치의 .ahk 파일을, 인라인 AutoHotkey 코드 실행으로 액션 안에 직접 작성한 코드를 실행.
• 단축키나 타이머가 있는 스크립트를 Macro Deck과 함께 시작하고, AutoHotkey 스크립트 전환으로 시작하고 중지. 버튼에 실행 중 또는 실행 중 아님이 표시됩니다.
• 스크립트에 값을 매개변수로 전달. Macro Deck은 값을 스크립트 텍스트에 삽입하지 않으므로 값이 코드를 망가뜨리거나 바꿀 수 없습니다. 스크립트는 값을 MacroDeck.Params["name"]으로 읽습니다.
• 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 스크립트를 실행하는 버튼이 이 액션으로 옮겨집니다.