AutoHotkey
Dołączona do Macro DeckPrzechowuj skrypty AutoHotkey v2 w Macro Deck, uruchamiaj je i zatrzymuj przyciskiem, a skrypty mogą odczytywać i ustawiać zmienne.
Karta Skrypty integracji AutoHotkey z listą skryptów i jednym skryptem otwartym w edytorze
- Pisanie, sprawdzanie i testowanie skryptów AutoHotkey v2 w Macro Deck
- Uruchamianie skryptów, plików .ahk lub kodu wbudowanego z przycisku
- Uruchamianie, zatrzymywanie i przełączanie skryptów, które działają stale
- Bezpieczne przekazywanie wartości jako parametrów
- Skrypty mogą odczytywać i ustawiać zmienne oraz wyświetlać powiadomienia
Integracja AutoHotkey uruchamia skrypty AutoHotkey v2 z przycisków i automatyzacji: wysyłanie klawiszy do okna w tle, układanie okien, skróty klawiszowe dla konkretnych aplikacji i wszystko inne, co potrafi AutoHotkey. Jest dostępna tylko w systemie Windows i pozostaje wyłączona, dopóki nie zostanie włączona. Macro Deck nie zawiera AutoHotkey; wyszukuje zainstalowany AutoHotkey v2 lub wskazaną wersję przenośną. AutoHotkey v1 nie jest obsługiwany.
Możliwości
- Przechowywanie skryptów na karcie Skrypty integracji, edycja z podświetlaniem składni, sprawdzanie przyciskiem Sprawdź składnię i uruchamianie bezpośrednio tam. Ostatnie uruchomienie pokazuje przebieg ostatniego uruchomienia: wynik, błędy z numerem wiersza i dane wyjściowe skryptu.
- Uruchamianie skryptu z biblioteki akcją Uruchom skrypt AutoHotkey, pliku
.ahkw miejscu jego zapisania akcją Uruchom plik AutoHotkey lub kodu wpisanego bezpośrednio w akcji za pomocą Uruchom wbudowany kod AutoHotkey. - Uruchamianie skryptów ze skrótami klawiszowymi lub timerami razem z Macro Deck oraz ich uruchamianie i zatrzymywanie akcją Przełącz skrypt AutoHotkey. Przycisk pokazuje Działa lub Nie działa.
- Przekazywanie wartości do skryptu jako Parametry. Macro Deck nigdy nie wstawia wartości do tekstu skryptu, więc wartość nie może zepsuć ani zmienić kodu. Skrypt odczytuje je jako
MacroDeck.Params["name"]. - Komunikacja zwrotna skryptu przez pomocnika Macro Deck:
MacroDeck.GetVariMacroDeck.SetVarodczytują i ustawiają zmienne,MacroDeck.Notifywyświetla powiadomienie, aMacroDeck.SetResultprzekazuje wynik do akcji. - Uruchamianie automatyzacji, gdy skrypt się uruchomi, zakończy lub zakończy się błędem.
Przykładowe zastosowania:
- Przycisk Przełącz skrypt AutoHotkey dla skryptu ze skrótami do gier, z osobnym wyglądem dla stanów Działa i Nie działa.
- Przycisk, który uruchamia skrypt z parametrem
volumeustawionym na{{ vars.volume }}, a skrypt wywołujeSoundSetVolume MacroDeck.Params["volume"]. - Automatyzacja na zdarzenie Błąd skryptu AutoHotkey, która wyświetla
{{ event.reason }}na przycisku.
Działanie skryptów
AutoHotkey nigdy nie wyświetla swoich okien błędów dla skryptów uruchamianych przez Macro Deck: błędy wczytywania i błędy w trakcie działania pojawiają się w sekcji Ostatnie uruchomienie, a akcja, która czeka na skrypt, kończy się niepowodzeniem. Zatrzymywany skrypt jest najpierw proszony o zamknięcie, aby wykonała się jego procedura OnExit, a po upływie czasu ustawionego w polu Czas na zatrzymanie w sekundach zostaje zakończony. Zatrzymywanie i przełączanie dotyczą tylko skryptów uruchomionych przez Macro Deck. Gdy Macro Deck się zamyka lub integracja zostaje wyłączona, zatrzymuje wszystkie uruchomione przez siebie skrypty AutoHotkey.
Po migracji z Macro Deck 2 przyciski wtyczki AutoHotkey autorstwa jbcarreon123, które uruchamiają skrypty AutoHotkey v2, przechodzą na te akcje.
Czego potrzebujesz
- Windows.
- AutoHotkey v2, zainstalowany lub przenośny. Macro Deck go nie zawiera.
Konfiguracja krok po kroku
Krok 1: Zainstaluj AutoHotkey v2
Pobierz AutoHotkey v2 ze strony autohotkey.com i zainstaluj go. Macro Deck znajdzie go w miejscu, w którym umieścił go instalator.
Krok 2: Włącz integrację
W Macro Deck kliknij Integracje na pasku bocznym, a następnie AutoHotkey i włącz przełącznik w prawym górnym rogu. Gdy Macro Deck nie może znaleźć AutoHotkey v2, strona pokazuje Nie znaleziono AutoHotkey: zainstaluj go i kliknij Sprawdź ponownie.
Krok 3: Sprawdź ustawienia AutoHotkey
Na karcie Przegląd kliknij Skonfiguruj w sekcji Konfiguracja. Okno Ustawienia AutoHotkey pokazuje używany AutoHotkey i jego wersję. W przypadku przenośnego AutoHotkey ustaw Plik wykonywalny AutoHotkey na Wybierz plik wykonywalny i wskaż jego
AutoHotkey64.exew polu Plik wykonywalny. Kliknij Dalej.Krok 4: Napisz skrypt
Otwórz kartę Skrypty i kliknij + obok tytułu listy. Wpisz nazwę, kliknij Utwórz skrypt, a następnie napisz skrypt w edytorze, np.
MsgBox "Hello from Macro Deck". Kliknij Zapisz, a potem Uruchom, aby go wypróbować.Krok 5: Dodaj akcję do przycisku
Na stronie Deck kliknij przycisk, który ma zostać użyty. Deck musi być odblokowany: jest odblokowany, gdy przycisk w prawym górnym rogu ma etykietę Zablokuj. Otworzy się edytor z zaznaczonym Krótkie naciśnięcie. Kliknij + Dodaj akcję, po lewej stronie okna Dodaj akcję wybierz AutoHotkey i wybierz Uruchom skrypt AutoHotkey. Wybierz skrypt w polu Skrypt AutoHotkey, a następnie kliknij Zapisz.
Krok 6: Naciśnij przycisk
Naciśnij przycisk na decku. Skrypt zostanie uruchomiony, a Ostatnie uruchomienie na karcie Skrypty pokaże, jak przebiegł.
Akcje7
Przypisz je do przycisku lub uruchamiaj w przebiegu.
- Uruchom skrypt AutoHotkey
- Uruchamia skrypt z karty Skrypty z parametrami i może czekać na jego zakończenie.
- Uruchom plik AutoHotkey
- Uruchamia plik
.ahkw miejscu, w którym jest zapisany na komputerze, z argumentami wA_Argsi parametrami. - Uruchom wbudowany kod AutoHotkey
- Uruchamia kod AutoHotkey v2 wpisany bezpośrednio w akcji.
- Zatrzymaj skrypt AutoHotkey
- Zatrzymuje skrypt lub plik uruchomiony przez Macro Deck: wszystkie instancje lub tylko ostatnią.
- Uruchom ponownie skrypt AutoHotkey
- Zatrzymuje skrypt lub plik i uruchamia go ponownie z nowymi parametrami albo uruchamia go, gdy nie działa.
- Przełącz skrypt AutoHotkey
- Uruchamia skrypt lub plik, gdy Macro Deck go nie uruchomił, i zatrzymuje go, gdy działa. Pokazuje na przycisku Działa lub Nie działa.
- Otwórz Window Spy
- Otwiera Window Spy z AutoHotkey, w którym można sprawdzić tytuły, klasy i kontrolki okien.
Wyzwalacze3
Przycisk lub przebieg może reagować na te zdarzenia.
- Skrypt AutoHotkey uruchomiony
- Skrypt uruchomiony przez Macro Deck został wczytany i działa.
- Skrypt AutoHotkey zakończony
- Taki skrypt się zakończył; zdarzenie przekazuje kod wyjścia i czas działania.
- Błąd skryptu AutoHotkey
- Nie udało się uruchomić lub wczytać skryptu, skrypt zgłosił błąd albo nie zakończył się na czas.
Zmienne4
Wyświetlaj te wartości na przyciskach i widżetach albo używaj ich w warunkach.
autohotkey_installed,autohotkey_version- Czy Macro Deck znalazł działający AutoHotkey v2 oraz jego wersja.
autohotkey_running_scripts- Liczba skryptów AutoHotkey uruchomionych przez Macro Deck, które w tej chwili działają.
autohotkey_last_script,autohotkey_last_exit_code,autohotkey_last_result,autohotkey_last_error- Skrypt, który jako ostatni się zakończył lub zakończył błędem, jego kod wyjścia, wynik zgłoszony przez
MacroDeck.SetResulti przyczyna błędu, jeśli wystąpił. autohotkey_script_<name>_running- Czy działa skrypt z biblioteki, osobno dla każdego skryptu. Nazwa nie zmienia się po zmianie nazwy skryptu.
Najczęściej zadawane pytania
Czy to działa ze skryptami AutoHotkey v1?
Nie. Macro Deck obsługuje tylko AutoHotkey v2, a kod napisany dla AutoHotkey v1 nie wczytuje się w v2. Sprawdź składnię na karcie Skrypty pokazuje wiersz pierwszego błędu.
Jak przekazać wartość z Macro Deck do skryptu?
Dodaj ją jako parametr w akcji, np. volume z wartością {{ vars.volume }}, i odczytaj ją w skrypcie jako MacroDeck.Params["volume"]. Wartości zawsze docierają jako tekst, dokładnie w takiej postaci, w jakiej je wpisano. Skrypt może też w dowolnej chwili odczytać zmienną za pomocą MacroDeck.GetVar("name").
Dlaczego skrypt nie wysyła klawiszy do gry lub narzędzia?
Macro Deck uruchamia skrypty bez uprawnień administratora, a Windows nie pozwala im wysyłać klawiszy ani kliknięć do okna programu działającego z uprawnieniami administratora.
Co się dzieje ze skryptami po zamknięciu Macro Deck?
Macro Deck zatrzymuje wszystkie uruchomione przez siebie skrypty AutoHotkey, gdy się zamyka lub gdy integracja zostanie wyłączona. Włącz Uruchamiaj razem z Macro Deck w sekcji Ustawienia skryptu, aby działał zawsze, gdy działa Macro Deck. Programy otwarte przez skrypt pozostają otwarte.
Czy mogę dalej używać swoich plików .ahk?
Tak. Uruchom plik AutoHotkey uruchamia plik w miejscu, w którym jest zapisany, więc A_ScriptDir wskazuje jego folder. Plik można też zaimportować do biblioteki na karcie Skrypty.
Więcej w kategorii Twój komputer
System
Dołączona do Macro DeckSteruj komputerem z decku: aplikacje, głośność, polecenia, powiadomienia, uśpienie i wyłączanie.
Klawiatura
Dołączona do Macro DeckNaciskaj skróty, wpisuj tekst i uruchamiaj sekwencje klawiszy na komputerze z poziomu przycisku.
Mysz
Dołączona do Macro DeckKlikaj, przesuwaj wskaźnik, przeciągaj i przewijaj na komputerze z poziomu przycisku.
ADB / Android Debug Bridge
Dołączona do Macro DeckSteruj telefonem lub tabletem z Androidem przez USB albo Wi-Fi: wybudzaj go, uruchamiaj aplikacje, dotykaj, wpisuj tekst i rób zrzuty ekranu.
Steam
Dołączona do Macro DeckUruchamiaj i zamykaj gry Steam oraz pokazuj na decku bieżącą grę, znajomych i bibliotekę.