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

لمحة عن هذا الدرس التطبيقي حول الترميز
schedule34 دقيقة
subjectتاريخ التعديل الأخير: 26 سبتمبر 2023
account_circleتأليف: Jonathan Donald and Andres Gomez
  • طريقة تصميم نموذج التشغيل الآلي وكتابةه.
  • كيفية اختبار نموذج التشغيل الآلي باستخدام Google Home Developer Console
  • هاتف Android أو iOS يتضمّن تطبيق Google Home
  • قد يكون استخدام مصباح ذكي مثبَّت في منزلك أو جهاز محاكاة في ساحة لعب Google Home.

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

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

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

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"، سيقتصر اختياره على الأجهزة من النوع الذي حدّدته.
  • يتوفّر أيضًا في القسم input متغيّران باسم time_on وtime_off. ويسمح ذلك للمستخدم بتحديد وقت بدء عمليات التشغيل الآلي. تشير السمة time_on إلى وقت تشغيل الضوء، وتمثّل time_off وقت إطفاء المصباح. إذا لم يضبط المستخدم القيمة time_on أو time_off، يتم استخدام القيمتَين التلقائيتَين.
  • يتضمّن قسم automations في التشغيل الآلي قاعدتَين من قواعد التشغيل الآلي. تتضمّن كل قاعدة إجراء تفعيل time.schedule واحدًا لإعلام عملية التشغيل الآلي بوقت بدء التشغيل الآلي.

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

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

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

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

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

  1. يُرجى التأكّد من توصيل المصباح وظهوره في تطبيق Google Home.
  2. إذا كان المصباح مضاءً، عليك إطفاؤه.
  3. انتقِل إلى وحدة تحكّم المطوّرين في Google Home.
  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، يمكنك الاطّلاع على المستندات المرجعية الخاصة بهذه العمليات: