Macro Deck Companion
مضمّن في Macro Deckتحكّم في الهواتف والأجهزة اللوحية التي تعمل بتطبيق Companion: السطوع والتدوير والشاشة ولقطات الشاشة.
نافذة ربط جهاز في تكامل Macro Deck Companion، وهي بلا حقول
- ضبط سطوع شاشة الجهاز واتجاهها
- تشغيل الشاشة وإطفاؤها على Android
- حفظ لقطات من اللوحة كملفات PNG على حاسوبك
- البطارية والشبكة والذاكرة لكل جهاز كمتغيرات
- المشغّل «الجهاز جاهز» عند اتصال جهاز
يربط تكامل Macro Deck Companion بين Macro Deck والهواتف والأجهزة اللوحية التي تعمل بتطبيق Macro Deck Companion لنظام Android وiPhone وiPad. يحصل كل جهاز يتصل على تهيئة خاصة به، فتستطيع إرسال أوامر إلى جهاز لوحي محدد وقراءة ما يُبلغ عنه، إلى جانب كل أجهزتك الأخرى.
لا تُدخل أي شيء لإعداده. افتح تطبيق Companion على الجهاز واربطه بحاسوبك. يظهر الجهاز بعدها في التكامل تلقائيًا، باسمه الخاص.
ما يمكنك فعله
تعمل الإجراءات على جهاز واحد في كل مرة. تختار الجهاز في حقل الجهاز لكل إجراء:
- يعمل ضبط سطوع الشاشة وضبط الاتجاه (تلقائي أو عمودي أو أفقي) على Android وiPhone وiPad.
- يعمل اهتزاز على Android وiPhone.
- يلتقط التقاط لقطة شاشة اللوحة، أو الشاشة كاملة على Android، ويحفظها كملف PNG في مجلد على حاسوبك.
- تعمل تشغيل الشاشة وإيقاف الشاشة وإحضار إلى الأمام على Android، بعد أن تسمح بها في Device control في إعدادات التطبيق.
ويُبلغ كل جهاز أيضًا عن حالته كمتغيرات: مستوى البطارية، والشحن، والاتجاه، وسطوع الشاشة، والطراز، والمنصة، وإصدار التطبيق، وما إذا كان Macro Deck في المقدمة، ونوع الشبكة واسمها، واستخدام المعالج والذاكرة. استخدمها في التسميات والشروط والأتمتة مثل أي متغير آخر.
أمثلة على الإعدادات
- جهاز لوحي يعمل كلوحة فقط: أتمتة على توقّف الخادم تنفّذ إيقاف الشاشة عند خروج Macro Deck، وأتمتة على الجهاز جاهز تنفّذ تشغيل الشاشة عند عودة الجهاز اللوحي.
- أتمتتان على تغيّر المتغير للمتغير
system_lockedمن تكامل النظام تطفئان شاشة الجهاز اللوحي عند قفل الحاسوب وتشغّلانها مجددًا عند إلغاء قفله. - حدث الجدول الزمني عند 22:00 ينفّذ ضبط سطوع الشاشة على 20 %، وآخر عند 08:00 يعيده إلى ما كان عليه.
- تسمية على لوحة هاتفك تعرض
companion_<configuration>_battery_level_percentللجهاز اللوحي المعلّق على الجدار، فتعرف متى يحتاج إلى الشحن. - زر مع التقاط لقطة شاشة يحفظ اللوحة كملف PNG، ويضع الخيار حفظ المسار في متغير مسار الملف في متغير للإجراء التالي.
يحتاج الإجراء إلى أن يكون الجهاز متصلًا. وعندما يكون قد اتصل للتو، ينتظر الإجراء بضع ثوانٍ حتى يصبح جاهزًا. عندما لا يكون الجهاز متصلًا، تظهر متغيراته غير متاحة، باستثناء companion_<configuration>_is_connected الذي يحمل القيمة false.
ما تحتاج إليه
- Macro Deck 3 على حاسوبك
- تطبيق Macro Deck Companion على Android 6 أو أحدث، أو iOS وiPadOS 15 أو أحدث
- ترخيص تطبيق Companion أو الفترة التجريبية المجانية لمدة 7 أيام
- وجود الجهاز في الشبكة نفسها التي يتصل بها الحاسوب، أو توصيله عبر USB
- على Android، الأذونات في Device control في التطبيق لتشغيل الشاشة وإطفائها وللإجراء إحضار إلى الأمام
خطوات الإعداد
الخطوة 1: ثبّت تطبيق Companion
ثبّت Macro Deck Companion من Google Play أو App Store على هاتفك أو جهازك اللوحي. ابدأ الفترة التجريبية المجانية لمدة 7 أيام أو اشترِ الترخيص.
الخطوة 2: اربط الجهاز بـ Macro Deck
في Macro Deck على الحاسوب، افتح لوحة الشبكة من أيقونة الشبكة في أعلى اليسار. في التطبيق، انقر Add connection (على iPhone وiPad، +)، واختر Scan QR code وامسح الرمز الظاهر في اللوحة. يمكنك أيضًا اختيار الحاسوب في Found on this network أو إدخال عنوانه.
الخطوة 3: اعثر على الجهاز في التكامل
في الشريط الجانبي، انقر التكاملات ثم Macro Deck Companion. بمجرد أن يتصل جهاز، يظهر تلقائيًا باسمه تحت الإعدادات في علامة التبويب نظرة عامة، ويكون المفتاح في أعلى اليسار مشغّلًا. إذا كنت قد عطّلت التكامل من قبل، فشغّل المفتاح مجددًا. يفتح إضافة تهيئة نافذة ربط جهاز، وهي لا تحتوي على حقول وتشرح ذلك فقط. يغيّر إعادة التسمية الاسم الذي يستخدمه Macro Deck للجهاز.
الخطوة 4: اسمح بالتحكم في الجهاز على Android
لتشغيل الشاشة وإطفائها أو إحضار اللوحة إلى المقدمة، افتح إعدادات التطبيق على جهاز Android وفعّل الأذونات في Device control. يحتاج تشغيل الشاشة أيضًا إلى Background connection وDisplay over other apps، حتى يبقى الجهاز متصلًا وشاشته مطفأة.
الخطوة 5: أضف إجراء Companion إلى زر
في صفحة اللوحة، تأكد من أن اللوحة غير مقفلة (يعرض الزر في أعلى اليسار قفل)، ثم انقر زرًا. يُفتح المحرر مع تحديد ضغطة قصيرة. انقر + إضافة إجراء، واختر Macro Deck Companion على يمين نافذة إضافة إجراء، ثم اختر إجراءً، مثل ضبط سطوع الشاشة. اختر الجهاز في الجهاز واضبط القيمة.
الخطوة 6: اضغط الزر
انقر حفظ واضغط الزر على أي من لوحاتك. ينفّذ الجهاز الأمر ما دام متصلًا بـ Macro Deck.
الإجراءات7
ضعها على زر أو شغّلها من تدفق.
- ضبط سطوع الشاشة
- يضبط سطوع شاشة جهاز Companion، من 0 إلى 100 %.
- ضبط الاتجاه
- يثبّت جهاز Companion على الوضع العمودي أو الأفقي، أو يتركه يدور تلقائيًا.
- اهتزاز
- يجعل جهاز Companion يهتز لفترة قصيرة (Android وiPhone).
- تشغيل الشاشة
- يشغّل شاشة جهاز Companion ويعرض Macro Deck هذا (Android).
- إيقاف الشاشة
- يطفئ شاشة جهاز Companion (Android).
- إحضار إلى الأمام
- يعرض لوحة Macro Deck هذا في المقدمة على جهاز Companion (Android).
- التقاط لقطة شاشة
- يلتقط اللوحة أو، على Android، الشاشة كاملة لجهاز ويحفظها كملف PNG في مجلد على حاسوبك.
المشغّلات1
يمكن لزر أو تدفق أن يستجيب لهذه الأحداث.
- الجهاز جاهز
- يعمل عندما يتصل تطبيق Companion ويصبح قادرًا على تنفيذ إجراءات Companion، ويمكن قصره على جهاز واحد.
المتغيرات15
اعرض هذه القيم على الأزرار والأدوات، أو استخدمها في الشروط.
companion_<configuration>_is_connected- ما إذا كان الجهاز متصلًا الآن.
companion_<configuration>_battery_level_percent- شحن البطارية بالنسبة المئوية.
companion_<configuration>_charging- ما إذا كان الجهاز قيد الشحن.
companion_<configuration>_orientation- ما إذا كان الجهاز في الوضع العمودي أو الأفقي.
companion_<configuration>_screen_brightness_percent- سطوع الشاشة بالنسبة المئوية.
companion_<configuration>_model- طراز الجهاز.
companion_<configuration>_platform- نظام التشغيل وإصداره، مثل
Android 14. companion_<configuration>_app_version- إصدار تطبيق Companion.
companion_<configuration>_in_focus- ما إذا كان Macro Deck في المقدمة على الجهاز.
companion_<configuration>_network_type- نوع الشبكة: Wi-Fi أو بيانات خلوية أو Ethernet أو VPN أو لا شيء.
companion_<configuration>_network_metered- ما إذا كانت الشبكة محدودة الاستخدام.
companion_<configuration>_network_validated- ما إذا كانت الشبكة تصل إلى الإنترنت.
companion_<configuration>_network_name- اسم شبكة Wi-Fi، على Android مع إذن قراءة اسم Wi-Fi.
companion_<configuration>_cpu_usage_percent- استخدام المعالج بالنسبة المئوية، على iOS.
companion_<configuration>_memory_used_percent- الذاكرة المستخدمة بالنسبة المئوية.
الأسئلة الشائعة
هل أحتاج إلى تطبيق Companion لاستخدام Macro Deck على هاتف؟
لا. يستطيع كل جهاز بمتصفح حديث استخدام عميل الويب المجاني. أما إجراءات هذا التكامل ومتغيراته فتحتاج إلى تطبيق Companion، لأن المتصفح لا يستطيع التحكم في الجهاز نفسه.
لماذا يفشل تشغيل الشاشة أو إيقاف الشاشة؟
تعمل هذه الإجراءات على Android فقط، ومع الأذونات في Device control في إعدادات التطبيق فقط. يحتاج تشغيل الشاشة أيضًا إلى Background connection وDisplay over other apps، حتى يبقى الجهاز متصلًا وشاشته مطفأة. على iPhone وiPad، لا يستطيع أي تطبيق تشغيل الشاشة أو إطفاءها.
ماذا يحدث عندما لا يكون الجهاز متصلًا؟
يفشل الإجراء الخاص بذلك الجهاز برسالة جهاز Companion غير متصل. تظهر متغيراته غير متاحة، ويحمل companion_<configuration>_is_connected القيمة false. عندما يتصل الجهاز مجددًا، يعمل الجهاز جاهز وتتحدّث المتغيرات.
هل يمكنني استخدام عدة هواتف وأجهزة لوحية؟
نعم. يحصل كل جهاز يتصل على تهيئة خاصة به، مع متغيراته الخاصة. في كل إجراء تختار الجهاز في الجهاز.
أين تُحفظ لقطات الشاشة؟
على الحاسوب الذي يعمل عليه Macro Deck، في المجلد الذي تختاره في الإجراء، باسم companion-screenshot-<date>-<time>.png. تتطلب لقطة اللوحة أن تكون اللوحة على شاشة الجهاز. وتعمل لقطة الشاشة الكاملة على Android فقط، بعد أن تسمح بها على الجهاز.
هل تستطيع الإضافات استخدام أجهزة Companion الخاصة بي أيضًا؟
فقط ما دام السماح للمكوّنات الإضافية باستخدام أجهزة Companion مفعّلًا في وصول المكوّنات الإضافية في الإعدادات > تطبيق المرافقة. يبقى معطّلًا حتى تفعّله. ولا يؤثر في إجراءات هذا التكامل ومتغيراته ومشغّله.
المزيد في Macro Deck
Macro Deck Delegate
مضمّن في Macro Deckشغّل نصوصًا برمجية على حاسوب آخر يعمل عليه Macro Deck واستخدم المتغيرات التي يشاركها.
النصوص البرمجية
مضمّن في Macro Deckابنِ مجموعة إجراءات مرة واحدة كنص برمجي وشغّلها من أي زر أو أتمتة أو نص برمجي آخر.
المتغيرات
مضمّن في Macro Deckغيّر متغيراتك من الأزرار والأتمتة، واكتب أي متغير إلى ملف.