إنشاء برمجة آلية للنص البرمجي

1. مقدمة

المُعطيات

• كيفية تخطيط وكتابة برمجة نصية
• كيفية اختبار برمجة نصية

المتطلبات

• هاتف Android أو iOS يتضمّن تطبيق Google Home
• مصباح ذكي أو جهاز آخر معتمَد للعمل مع Google Home ويمكن تشغيله أو إيقافه.

2. إعداد الجهاز

إذا لم يسبق لك إعداد جهازك، يمكنك المتابعة وإعداد�� في منزلك.

يُرجى التأكُّد من ظهور الجهاز في تطبيق Google Home وأنّ بإمكانك تشغيله وإيقافه باستخدام تطبيق Home.

3- التخطيط للبرمجة النصية

سنبدأ بالتفكير في ما نريد أن تفعله برمجة النصوص البرمجية. ويشمل ذلك بعض الاعتبارات:

• الأجهزة التي تريد تشغيلها تلقائيًا
• إجراء التفعيل (أو الحدث) الذي من المفترض أن يؤدي إلى تنفيذ عملية التشغيل الآلي النصية.
• ما هي الشروط الإضافية، إن وُجدت، التي تتحكّم في تشغيل التشغيل الآلي النصي بعد تشغيله أم لا.
• الإجراءات التي سيتم تنفيذها

لأغراض هذا الدرس التطبيقي حول الترميز، تتمثل خطتنا في أن يقوم التشغيل الآلي النصي بأمرين:

1. شغِّل المصباح (أو أي جهاز ذكي آخر) في وقت محدّد.
2. إيقاف تشغيل الجهاز في وقت محدد.

الآن بعد أن أصبحنا على دراية بما نريد أن تفعله برمجة النصوص البرمجية بالضبط، سنفتح محرِّر النصوص البرمجية ونكتب العملية البرمجية.

4. كتابة النص البرمجي للتشغيل الآلي

تتم كتابة عمليات التشغيل الآلي النصية بطريقة تعريفية باستخدام لغة تسلسل بيانات YAML.

تتألف عملية التشغيل الآلي النصية من قسمَين أساسيَين:

1. البيانات الوصفية - اسم عملية التشغيل الآلي النصية ووصف لوظيفتها.
2. قواعد التشغيل الآلي: لتحديد منطق بدء التشغيل الآلي وسلوكه

البيانات الوصفية

تخبر البيانات الوصفية لعملية التشغيل الآلي المستخدم باسمها ووظيفتها. يتم تحديد البيانات الوصفية في مجموعة metadata التي تبدو كما يلي:

metadata:
  name: Scheduled light
  description: Turn the light on and off at specific times

قواعد التشغيل الآلي

تمثّل قاعدة التشغيل الآلي المكان الذي يتم فيه العمل الفعلي. ويتكوّن البرنامج من ثلاثة أجزاء، وهي إجراءات التفعيل وال��روط والإجراءات، ويتم تقييمها بالترتيب:

يتضمّن الجزء automations من عمليات التشغيل الآلي قاعدتَين:

automations:
  - starters:
      - type: time.schedule
        at: 1:00 PM
    actions:
      - type: device.command.OnOff
        devices: Desk light - Office
        on: true
  - starters:
      - type: time.schedule
        at: 1:05 PM
    actions:
      - type: device.command.OnOff
        devices: Desk light - Office
        on: false

يُرجى ملاحظة ما يلي:

1. هناك قاعدتان من النوع automations. الأولى تعمل على تشغيل الضوء، والثانية تطفئ الضوء.
2. لكل قاعدة إجراء واحد.
3. on: true تعني تشغيل الضوء. وبالمثل، تعني on: false إطفاء الضوء.
4. تتضمّن كل قاعدة إجراء تفعيل time.schedule واحدًا لإعلام عملية التشغيل الآلي بوقت بدء التشغيل الآلي.
5. ما مِن شروط في عملية التشغيل الآلي هذه.

5- التشغيل الآلي الكامل للنص البرمجي

بتجميع كل ��ذه الأجزاء م��ًا، ��ل��ك ما تبدو عليه عملية التشغيل الآلي النصية الكاملة:

metadata:
  name: Scheduled light
  description: Turn the light on and off at specific times
automations:
  - starters:
      - type: time.schedule
        at: 1:00 PM
    actions:
      - type: device.command.OnOff
        devices: Desk light - Office
        on: true
  - starters:
      - type: time.schedule
        at: 1:05 PM
    actions:
      - type: device.command.OnOff
        devices: Desk light - Office
        on: false

1. انسخ عملية التشغيل الآلي (أعلاه).
2. انتقِل إلى Google Home للويب.
3. انقر على علامة تبويب "عمليات التشغيل الآلي"، ويمثّلها رمز بثلاث نجوم:
   
4. انقر على + إضافة جديدة.
5. في محرِّر النصوص البرمجية، احذف نموذج التشغيل الآلي.
6. ألصِق التشغيل الآلي.
7. استبدِل Desk light - Office باسم جهازك وموقعه الجغرافي.
8. انقر على التحقق من الصحة. تسطير أداة تعديل النصوص البرمجية أقسام عملية التشغيل الآلي النصية التي تحتوي على أخطاء. حل أي أخطاء قد تظهر واستمر في التحقق من الأخطاء وإصلاحها حتى لا تكون هناك أخطاء أخرى. على سبيل المثال، قد يكون اسم جهازك مختلفًا. وفي هذه الحالة، يمكنك استخدام ميزة الإكمال التلقائي لاختيار اسم جهاز صالح.
9. انقر على حفظ.
10. تأكَّد من أنّ مفتاح التبديل تفعيل، تحت نص النص البرمجي، في الموضع تفعيل:

6- اختبار التشغيل الآلي

1. يُرجى التأكّد من توصيل الجهاز بمصدر طاقة ورؤيته في تطبيق Google Home.
2. إذا كان الجهاز قيد التشغيل حاليًا، عليك إيقاف��.
3. في صفحة عمليات التشغيل الآلي ضمن صفحة Google الرئيسية للويب، انقر على "تشغيل". بجانب التشغيل الآلي.
   
4. يُفترَض أن يتم توصيل الجهاز.

الآن، لنختبر التشغيل الآلي.

1. أطفِئ الجهاز.
2. تعديل التشغيل الآلي وتغيير "تشغيل الجهاز" الوقت في السطر 7 إلى وقت خمس دقائق في المستقبل.
3. تغيير "إطفاء الجهاز" الوقت في السطر 14 إلى وقت يقع بعد فترة وجيزة من "في الوقت المحدد".
4. انقر على التحقق من الصحة. يُرجى حلّ أي أخطاء قد تحدث.
5. انقر على حفظ.
6. تأكّد من أنّ مفتاح التفعيل في الوضع تفعيل.
7. الانتظار حتى انتهاء وقتَي التفعيل. يُفترَض أن يتم تشغيل الجهاز، ثم ينطلق في الأوقات التي حدّدتها.

7. تهانينا!

رائع! لقد نجحت في إنشاء برمجة نصية البرمجية.

في هذا الدرس التطبيقي حول الترميز، تعلمتَ كيفية:

• كيفية تصميم وكتابة التشغيل الآلي.
• كيفية اختبار التشغيل الآلي

الخطوات التالية

أنشأنا في هذا الدرس التطبيقي حول الترميز عملية تشغيل آلي بسيطة للغاية. لا تقتصر مهام عمليات التشغيل الآلي على تحديد موعد لتبديل مفتاح التشغيل. بعد أن فهمت أساسيات إنشاء التشغيل الآلي، يمكنك استكشاف الأنواع المختلفة من إجراءات التفعيل والشروط والإجراءات المتوفرة في منظومة Google Home المتكاملة.

جرّب التمارين التالية:

• أضِف المزيد من إجراءات تفعيل "time.schedule" إلى التشغيل الآلي.
• ويمكنك تعديل التشغيل الآلي لتشغيل جهاز آخر وإيقافه في الجدول الزمني نفسه.
• بدون إزالة إجراءات التفعيل الخاصة بـ "time.schedule"، عدِّل التشغيل الآلي ليتم تشغيل الأجهزة فقط عندما يكون جهاز آخر قيد التشغيل. راجِع أمثلة على النصوص البرمجية التي تستخدم عبارة condition.
• يُرجى تعديل التشغيل الآلي ليتم تشغيل الأجهزة فقط عند تواجد أحد الأفراد في المنزل.

محتوى إضافي للقراءة

للاطّلاع على مزيد من المعلومات عن عمليات التشغيل الآلي في Google Home، يمكنك الاطّلاع على المستندات المرجعية الخاصة بهذه العمليات:

• البدء بسرعة
• إجراءات التفعيل والشروط والإجراءات المتوافقة