النصوص البرمجية
مضمّن في Macro Deckابنِ مجموعة إجراءات مرة واحدة كنص برمجي وشغّلها من أي زر أو أتمتة أو نص برمجي آخر.
نص برمجي في صفحة النصوص البرمجية مع إجراءي انتظار وضغط مفتاح أو تركيبة
- إعادة استخدام الإجراءات نفسها على أزرار كثيرة
- منح كل مُستدعٍ قيم إدخال خاصة به
- تغيير النص البرمجي مرة واحدة، فتتبعه كل الأزرار
- مدمج ويعمل دائمًا، دون أي إعداد
النصوص البرمجية مدمجة في Macro Deck وتعمل دائمًا. تضيف الإجراء تشغيل النص البرمجي، الذي يشغّل أحد نصوصك البرمجية وينتظر انتهاءه. النص البرمجي مجموعة إجراءات تبنيها مرة واحدة في صفحة النصوص البرمجية، ثم تشغّلها من أي عدد تريده من الأزرار والأتمتة والنصوص البرمجية الأخرى. وعندما تغيّر النص البرمجي، يستخدم كل مكان يشغّله الإصدار الجديد.
المدخلات
يمكن للنص البرمجي أن يعلن عن مدخلات: قيم يملؤها المُستدعي عند تشغيل النص البرمجي. للمُدخل اسم ونوع (نص أو رقمي أو منطقي أو لون) وقيمة افتراضية اختيارية. داخل النص البرمجي تقرؤه كمتغير، مثل {{ vars.scene }}. عندما تختار النص البرمجي في تشغيل النص البرمجي، تظهر مدخلاته كحقول في الإجراء، فيستطيع كل زر تمرير قيمته الخاصة.
ويمكن أيضًا وسم النص البرمجي بـ يعمل على أداة. حينها يستهدف الخيار «هذه الأداة» داخل النص البرمجي الأداة التي شغّلته أيًا كانت، فيستطيع نص برمجي واحد تغيير الزر الذي ضُغط لتشغيله.
أمثلة على الإعدادات
- نص برمجي ابدأ البث يبدّل مشهد OBS، ويبدأ البث، وينقل اللوحة إلى ملف تعريف البث. تشغّله ثلاثة أزرار في ملفات تعريف مختلفة باستخدام تشغيل النص البرمجي.
- نص برمجي تبديل المشهد مع مُدخل نصي
sceneيشغّله زر لكل مشهد، ولكل زر اسم مشهده الخاص. - أتمتة على حدث الجدول الزمني تشغّل النص البرمجي نفسه الذي يشغّله زر، فتستطيع بدءه يدويًا أو في وقت محدد.
يمكن تشغيل النصوص البرمجية من أماكن أخرى أيضًا. يستطيع أي جهاز مسجّل الدخول إلى Macro Deck عرض كل نص برمجي لا يعمل على أداة وتشغيله، بقيم إدخاله الخاصة. على iPhone وiPad، يفعل Macro Deck Companion ذلك من Shortcuts أو Siri. لتشغيل نص برمجي على حاسوب آخر يعمل عليه Macro Deck، استخدم تشغيل نص برمجي على جهاز كمبيوتر آخر من Macro Deck Delegate.
لا تظهر النصوص البرمجية في صفحة التكاملات وليست لها نافذة إعداد. وفئتها النصوص البرمجية موجودة دائمًا في نافذة إضافة إجراء.
ما تحتاج إليه
- Macro Deck 3
- نص برمجي واحد على الأقل في صفحة النصوص البرمجية
خطوات الإعداد
الخطوة 1: أنشئ نصًا برمجيًا
في الشريط الجانبي، انقر النصوص البرمجية ثم +. في نافذة نص برمجي جديد، أدخل الاسم، مثل بدء البث، والوصف إن أردت، ثم انقر إنشاء نص برمجي.
الخطوة 2: أضف الإجراءات
في علامة التبويب الإجراءات، انقر + إضافة إجراء وأضف الإجراءات التي يجب أن ينفّذها النص البرمجي، بالترتيب. انقر حفظ التغييرات عند الانتهاء. يجرّب تشغيل النص البرمجي المحفوظ فورًا.
الخطوة 3: أضف مدخلات إن احتجت إليها
في علامة التبويب الإدخالات، انقر إضافة إدخال لكل قيمة يجب أن يملأها المُستدعي. اضبط الاسم والنوع، والافتراضي إن أردت. استخدمه في الإجراءات على هيئة
{{ vars.<name> }}. انقر حفظ التغييرات.الخطوة 4: شغّل النص البرمجي من زر
في صفحة اللوحة، تأكد من أن اللوحة غير مقفلة (يعرض الزر في أعلى اليسار قفل)، ثم انقر زرًا. يُفتح المحرر مع تحديد ضغطة قصيرة. انقر + إضافة إجراء، واختر النصوص البرمجية على يمين نافذة إضافة إجراء، ثم اختر تشغيل النص البرمجي. اختر نصك البرمجي في النص البرمجي واملأ مدخلاته.
الخطوة 5: اضغط الزر
انقر حفظ واضغط الزر. يعمل النص البرمجي، وينتهي تشغيل النص البرمجي عندما ينتهي النص البرمجي.
الإجراءات1
ضعها على زر أو شغّلها من تدفق.
- تشغيل النص البرمجي
- يشغّل أحد نصوصك البرمجية، مع قيم إدخاله، وينتظر انتهاءه.
الأسئلة الشائعة
هل عليّ تفعيل تكامل النصوص البرمجية؟
لا. إنه مدمج في Macro Deck ويعمل دائمًا. لا يظهر في صفحة التكاملات، وتشغيل النص البرمجي موجود دائمًا في نافذة إضافة إجراء.
ماذا يحدث للأزرار عند حذف نص برمجي؟
لا تفعل شيئًا بعد ذلك. قبل أن تحذف نصًا برمجيًا، يخبرك Macro Deck بالأدوات والنصوص البرمجية الأخرى التي تشغّله.
لماذا يقول تشغيل النص البرمجي إنه لم يُحدَّد أي نص برمجي؟
لا يحتوي الإجراء على نص برمجي مختار في النص البرمجي. افتح الإجراء واختر واحدًا.
هل يمكنني تشغيل نص برمجي على حاسوب آخر؟
نعم، باستخدام Macro Deck Delegate. يشغّل إجراؤه تشغيل نص برمجي على جهاز كمبيوتر آخر نصًا برمجيًا على حاسوب آخر يعمل عليه Macro Deck.
هل يستخدم التشغيل تغييراتي غير المحفوظة؟
لا. يستخدم التشغيل دائمًا النص البرمجي المحفوظ. انقر حفظ التغييرات أولًا.
المزيد في Macro Deck
Macro Deck Companion
مضمّن في Macro Deckتحكّم في الهواتف والأجهزة اللوحية التي تعمل بتطبيق Companion: السطوع والتدوير والشاشة ولقطات الشاشة.
Macro Deck Delegate
مضمّن في Macro Deckشغّل نصوصًا برمجية على حاسوب آخر يعمل عليه Macro Deck واستخدم المتغيرات التي يشاركها.
المتغيرات
مضمّن في Macro Deckغيّر متغيراتك من الأزرار والأتمتة، واكتب أي متغير إلى ملف.