AutoHotkey
مضمّن في Macro Deckاحتفظ بنصوص AutoHotkey v2 البرمجية في Macro Deck، وشغّلها وأوقفها من زر، ودعها تقرأ المتغيرات وتضبطها.
علامة التبويب النصوص البرمجية لتكامل AutoHotkey مع قائمة بالنصوص البرمجية وأحدها مفتوح في المحرر
- كتابة نصوص AutoHotkey v2 البرمجية وفحصها واختبارها في Macro Deck
- تشغيل نصوص برمجية أو ملفات .ahk أو شيفرة مضمّنة من زر
- بدء النصوص البرمجية التي تستمر في العمل وإيقافها وتبديل تشغيلها
- تمرير القيم بأمان على هيئة معاملات
- تستطيع النصوص البرمجية قراءة المتغيرات وضبطها وعرض الإشعارات
يشغّل تكامل 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: يقرأ
MacroDeck.GetVarوMacroDeck.SetVarالمتغيرات ويضبطانها، ويعرضMacroDeck.Notifyإشعارًا، ويُبلغMacroDeck.SetResultالإجراء بنتيجة. - ابدأ أتمتة عندما يبدأ نص برمجي أو ينتهي أو يفشل.
بعض أمثلة الإعدادات:
- زر تبديل تشغيل نص AutoHotkey البرمجي لنص برمجي يحتوي على اختصارات الألعاب الخاصة بك، بمظهر خاص لكل من قيد التشغيل وغير قيد التشغيل.
- زر يشغّل نصًا برمجيًا مع ضبط المعامل
volumeعلى{{ vars.volume }}، ويستدعي النص البرمجيSoundSetVolume MacroDeck.Params["volume"]. - أتمتة على فشل نص AutoHotkey البرمجي تعرض
{{ event.reason }}على زر.
كيف تعمل النصوص البرمجية
لا يعرض AutoHotkey أبدًا نوافذ أخطائه للنصوص البرمجية التي يشغّلها Macro Deck: تظهر أخطاء التحميل وأخطاء وقت التشغيل تحت آخر تشغيل، وتؤدي إلى فشل الإجراء الذي ينتظر. يُطلب من النص البرمجي الذي يُوقَف أن يُغلق أولًا، فيعمل روتين OnExit الخاص به، ثم يُنهى بعد انقضاء مهلة الإيقاف بالثواني. لا يؤثر الإيقاف والتبديل إلا في النصوص البرمجية التي بدأها Macro Deck. عندما يُغلق Macro Deck أو توقف التكامل، يوقف كل نصوص AutoHotkey البرمجية التي بدأها.
عند الانتقال من Macro Deck 2، تنتقل أزرار إضافة AutoHotkey من jbcarreon123 التي تشغّل نصوص AutoHotkey v2 البرمجية إلى هذه الإجراءات.
ما تحتاج إليه
- Windows.
- AutoHotkey v2، مثبّتًا أو محمولًا. لا يتضمنه Macro Deck.
خطوات الإعداد
الخطوة 1: ثبّت AutoHotkey v2
نزّل AutoHotkey v2 من autohotkey.com وثبّته. يعثر عليه Macro Deck في المكان الذي وضعه فيه برنامج التثبيت.
الخطوة 2: فعّل التكامل
في Macro Deck، انقر التكاملات في الشريط الجانبي، ثم انقر AutoHotkey وشغّل المفتاح في أعلى اليسار. عندما لا يعثر Macro Deck على AutoHotkey v2، تعرض الصفحة لم يُعثر على AutoHotkey: ثبّته ثم انقر تحقق مرة أخرى.
الخطوة 3: تحقق من إعدادات AutoHotkey
في علامة التبويب نظرة عامة، انقر إعداد في قسم الإعدادات. تعرض إعدادات AutoHotkey برنامج AutoHotkey المستخدم وإصداره. لنسخة AutoHotkey محمولة، اضبط الملف التنفيذي لـ AutoHotkey على اختيار الملف التنفيذي واختر ملف
AutoHotkey64.exeالخاص بها في الملف التنفيذي. انقر متابعة.الخطوة 4: اكتب نصًا برمجيًا
افتح علامة التبويب النصوص البرمجية وانقر + بجوار عنوان القائمة. أدخل اسمًا، وانقر إنشاء نص برمجي، ثم اكتب النص البرمجي في المحرر، مثل
MsgBox "Hello from Macro Deck". انقر حفظ، ثم تشغيل لتجربته.الخطوة 5: أضف إجراءً إلى زر
في صفحة اللوحة، انقر الزر الذي تريد استخدامه. يجب أن تكون اللوحة غير مقفلة: عندما يعرض الزر في أعلى اليسار قفل، فهي غير مقفلة. يُفتح المحرر مع تحديد ضغطة قصيرة. انقر + إضافة إجراء، واختر AutoHotkey على يمين نافذة إضافة إجراء، ثم اختر تشغيل نص AutoHotkey البرمجي. اختر نصك البرمجي في نص AutoHotkey البرمجي، ثم انقر حفظ.
الخطوة 6: اضغط الزر
اضغط الزر على لوحتك. يعمل النص البرمجي، ويعرض آخر تشغيل في علامة التبويب النصوص البرمجية كيف جرى.
الإجراءات7
ضعها على زر أو شغّلها من تدفق.
- تشغيل نص AutoHotkey البرمجي
- يشغّل نصًا برمجيًا من علامة التبويب النصوص البرمجية مع معاملات، ويمكنه الانتظار حتى ينتهي.
- تشغيل ملف AutoHotkey
- يشغّل ملف
.ahkفي مكان تخزينه على حاسوبك، مع وسائط فيA_Argsومعاملات. - تشغيل شيفرة AutoHotkey مضمّنة
- يشغّل شيفرة AutoHotkey v2 مكتوبة في الإجراء نفسه.
- إيقاف نص AutoHotkey البرمجي
- يوقف نصًا برمجيًا أو ملفًا بدأه Macro Deck: كل النسخ العاملة، أو أحدثها فقط.
- إعادة تشغيل نص AutoHotkey البرمجي
- يوقف نصًا برمجيًا أو ملفًا ويبدؤه مجددًا بمعاملات جديدة، أو يبدؤه إن لم يكن قيد التشغيل.
- تبديل تشغيل نص AutoHotkey البرمجي
- يبدأ نصًا برمجيًا أو ملفًا عندما لا يشغّله Macro Deck، ويوقفه عندما يشغّله. يعرض قيد التشغيل أو غير قيد التشغيل على الزر.
- فتح Window Spy
- يفتح Window Spy الخاص بـ AutoHotkey للاطلاع على عناوين النوافذ وفئاتها وعناصر التحكم فيها.
المشغّلات3
يمكن لزر أو تدفق أن يستجيب لهذه الأحداث.
- بدأ تشغيل نص AutoHotkey البرمجي
- اكتمل تحميل نص برمجي بدأه Macro Deck وهو يعمل.
- انتهى نص AutoHotkey البرمجي
- انتهى نص برمجي من هذا النوع، مع رمز خروجه والمدة التي عمل فيها.
- فشل نص AutoHotkey البرمجي
- تعذّر بدء نص برمجي أو تحميله، أو أبلغ عن خطأ، أو لم ينتهِ في الوقت المحدد.
المتغيرات4
اعرض هذه القيم على الأزرار والأدوات، أو استخدمها في الشروط.
autohotkey_installed,autohotkey_version- ما إذا كان Macro Deck قد عثر على AutoHotkey v2 يعمل، وإصداره.
autohotkey_running_scripts- عدد نصوص AutoHotkey البرمجية التي يشغّلها Macro Deck الآن.
autohotkey_last_script,autohotkey_last_exit_code,autohotkey_last_result,autohotkey_last_error- آخر نص برمجي انتهى أو فشل، ورمز خروجه، والنتيجة التي أبلغ عنها باستخدام
MacroDeck.SetResult، وسبب فشله إن فشل. autohotkey_script_<name>_running- ما إذا كان نص برمجي من المكتبة يعمل، متغير واحد لكل نص برمجي. يبقى الاسم كما هو عند إعادة تسمية النص البرمجي.
الأسئلة الشائعة
هل يعمل مع نصوص AutoHotkey v1 البرمجية؟
لا. يدعم Macro Deck الإصدار AutoHotkey v2 فقط، ولا تُحمَّل الشيفرة المكتوبة لـ AutoHotkey v1 في v2. يعرض فحص الصياغة في علامة التبويب النصوص البرمجية سطر أول خطأ.
كيف أنقل قيمة من Macro Deck إلى نصي البرمجي؟
أضفها كمعامل في الإجراء، مثل volume بالقيمة {{ vars.volume }}، واقرأها في النص البرمجي على هيئة MacroDeck.Params["volume"]. تصل القيم دائمًا كنص، تمامًا كما أُدخلت. ويستطيع النص البرمجي أيضًا قراءة متغير في أي وقت باستخدام MacroDeck.GetVar("name").
لماذا لا يرسل نصي البرمجي المفاتيح إلى لعبة أو أداة؟
يشغّل Macro Deck النصوص البرمجية دون صلاحيات المسؤول، ولا يسمح Windows لها بإرسال المفاتيح أو النقرات إلى نافذة برنامج يعمل بصلاحيات المسؤول.
ماذا يحدث لنصوصي البرمجية عندما يُغلق Macro Deck؟
يوقف Macro Deck كل نصوص AutoHotkey البرمجية التي بدأها عندما يُغلق أو عندما توقف التكامل. فعّل التشغيل عند بدء Macro Deck في الإعدادات الخاصة بنص برمجي ليعمل كلما عمل Macro Deck. تبقى البرامج التي فتحها النص البرمجي مفتوحة.
هل يمكنني الاستمرار في استخدام ملفات .ahk الخاصة بي؟
نعم. يشغّل تشغيل ملف AutoHotkey الملف في مكان تخزينه، لذا يكون A_ScriptDir هو مجلده. ويمكنك أيضًا استيراد ملف إلى المكتبة في علامة التبويب النصوص البرمجية.
المزيد في حاسوبك
النظام
مضمّن في Macro Deckتحكّم في حاسوبك من لوحتك: التطبيقات ومستوى الصوت والأوامر والإشعارات والسكون وإيقاف التشغيل.
لوحة المفاتيح
مضمّن في Macro Deckاضغط الاختصارات، واكتب النصوص، وشغّل تسلسلات المفاتيح على حاسوبك من زر.
الماوس
مضمّن في Macro Deckانقر، وحرّك المؤشر، واسحب، ومرّر على حاسوبك من زر.
ADB / Android Debug Bridge
مضمّن في Macro Deckتحكّم في هاتف أو جهاز لوحي يعمل بنظام Android عبر USB أو Wi-Fi: أيقظه، وشغّل التطبيقات، وانقر، واكتب، والتقط لقطات الشاشة.
Steam
مضمّن في Macro Deckشغّل ألعاب Steam وأغلقها، واعرض ما تلعبه وأصدقاءك ومكتبتك على لوحتك.