إنشاء نموذج تلقائي

1. مقدمة

أهداف الدورة التعليمية

• كيفية تصميم نموذج تشغيل آلي وكتابته
• كيفية اختبار نموذج التشغيل الآلي باستخدام Google Home Play Console

المتطلبات

• هاتف Android أو iOS مثبّت عليه تطبيق Google Home
• إما مصباح ذكي تم إعداده في منزلك، أو جهاز محاكى في Google Home Playground

المتطلبات الأساسية

يجب أن تكون على دراية بكيفية كتابة التشغيل الآلي للأجهزة المنزلية في Google Home. إذا لم يسبق لك كتابة عملية تشغيل آلي، ننصحك بتجربة Create a scripted automation codelab قبل المتابعة.

2. نماذج التشغيل الآلي وحالاته

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

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

3- التخطيط لنموذج التشغيل الآلي

عند إنشاء عملية تشغيل آلي، يبدأ الشخص بالتفكير في المشكلة التي يحاول حلّها، وما ستفعله عملية التشغيل الآلي لحلّ المشكلة. ويشمل ذلك اعتبارات مثل:

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

لأغراض هذا الدرس العملي، ستنفّذ عملية التشغيل الآلي ما يلي:

1. تشغيل مصباح في وقت محدّد
2. إيقاف المصباح نفسه في وقت محدّد

مع وضع ذلك في الاعتبار، أنت الآن جاهز لفتح أداة تعديل النماذج وكتابة عملية التشغيل الآلي.

4. كتابة نموذج التشغيل الآلي

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

يتضمّن نموذج التشغيل الآلي ثلاثة أقسام أساسية:

1. بيانات التعريف: اسم عملية التشغيل الآلي ووصف لما تفعله، ويمكنك إضافة بعض العلامات التي تُستخدم لتصنيف عملية التشغيل الآلي. الكلمات الرئيسية هي:
   • الإضاءة والمقابس
   • المناخ والطاقة
   • الأمان والتوعية
   • الترفيه
   • الأجهزة والمزيد
2. الإدخال: يحدّد نوع الأجهزة التي من المفترض أن يتحكّم بها التشغيل الآلي. يستخدم محرّك التشغيل الآلي هذه المعلومات لمعرفة أنواع الإجراءات الصالحة للأجهزة المقصودة.
3. قواعد التشغيل الآلي: تحدّد منطق بدء التشغيل الآلي وسلوكه.

إليك نموذج التشغيل الآلي الذي ستعمل عليه:

metadata:
  name:
    en: Scheduled light
  description:
    en: Turn the light on and off at specific times
  tags:
    - LIGHTING AND PLUGS
input:
  the_light:
    metadata:
      name:
        en: The light
      description:
        en: The light to be controlled
    selector:
      type: device
      multiSelect: true
      supportedTypes:
        - LIGHT
  time_on:
    metadata:
      name:
        en: Time to turn on the light.
      description:
        en: The time of day to turn on the selected light.
    selector:
      type: time
      default: sunset+30min
  time_off:
    metadata:
      name:
        en: Time to turn off the light.
      description:
        en: The time of day to turn off the selected light.
    selector:
      type: time
      default: 10:00 pm
automations:
  - name: Turn on the light
    starters:
      - type: time.schedule
        at: $time_on
    actions:
      - type: device.command.OnOff
        devices: $the_light
        on: true
  - name: Turn off the light
    starters:
      - type: time.schedule
        at: $time_off
    actions:
      - type: device.command.OnOff
        devices: $the_light
        on: false

اقرأ النموذج ودوِّن الملاحظات التالية:

• يحتوي القسم metadata على اسم عملية التشغيل الآلي هذه ووصفها.
• يحدد القسم input متغيّرًا باسم the_light يحدد جهازًا من النوع LIGHT. وهذا يعني أنّه لا يمكن استخدام هذا النموذج إلا للأضواء، وليس لأنواع الأجهزة الأخرى. بعبارة أخرى، عندما يُطلب من المستخدم اختيار جهاز لتنفيذ الإجراء $the_light أثناء إعداد عملية التشغيل الآلي في منزله، يكون خياره من الأجهزة محصورًا بالأجهزة من النوع الذي حدّدته.
• يتم أيضًا تحديد متغيّرَين باسم time_on وtime_off في القسم input. تتيح هذه الإعدادات للمستخدم تحديد وقت بدء عمليات التشغيل الآلي. يمثّل time_on الوقت الذي يتم فيه تشغيل الضوء، ويمثّل time_off الوقت الذي يتم فيه إيقاف الضوء. وإذا لم يضبط المستخدم قيمة time_on أو time_off، يتم استخدام القيم التلقائية.
• يحتوي قسم automations من عملية التفعيل التلقائي على قاعدتَين للتفعيل التلقائي. تحتوي كل قاعدة على إجراء تفعيل واحد time.schedule يحدد الوقت الذي يجب أن تبدأ فيه عملية التشغيل الآلي.

محرّر النماذج

محرّر نماذج التشغيل الآلي هو الأداة التي تستخدمها لكتابة نماذج التشغيل الآلي.

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

5- اختبار النموذج

يمكنك الآن اختبار النموذج في Console.

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

    inputValue:
     #add value
     the_light: Desk light - Office
     #add value
     time_off: 11:45 am
     #add value
     time_on: 11:40 am
    

11. انقر على تفعيل الاختبار.
12. انتظِر إلى أن ينتهي الوقتان المحدّدان لبدء البث. من المفترض أن يضيء المصباح ثم ينطفئ في الأوقات المحدّدة.

بعد اختبار النموذج بنجاح، ستعرف أنّ عملية التشغيل الآلي تعمل بشكل سليم.

6. تهانينا!

لقد أنشأت نموذجًا لعملية تشغيل آلي بنجاح. رائع!

في هذا الدرس العملي، تعلّمت كيفية:

• كيفية تصميم نموذج تشغيل آلي وكتابته
• كيفية اختبارها في Google Home Developer Console

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

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

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

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

• نظرة عامة
• أساسيات المخطط
• بنية عمليات التشغيل الآلي
• الحالات والأوامر المتوافقة