1. مقدمة
ما ستتعرَّف عليه
- طريقة تصميم نموذج التشغيل الآلي وكتابةه.
- كيفية اختبار نموذج التشغيل الآلي باستخدام Google Home Developer Console
المتطلبات
- هاتف Android أو iOS يتضمّن تطبيق Google Home
- قد يكون استخدام مصباح ذكي مثبَّت في منزلك أو جهاز محاكاة في ساحة لعب Google Home.
المتطلبات الأساسية
من المفترض أن تكون على دراية بطريقة كتابة نظام التشغيل الآلي لجهاز Google Home. إذا لم يسبق لك كتابة أي عملية تشغيل آلي، ننصحك بإجراء الدرس التطبيقي حول ترميز إنشاء عملية تشغيل آلي نصي قبل مواصلة تنفيذ هذا الإجراء.
2. نماذج التشغيل الآلي ومثيلاته
ينشئ المطوّرون نماذج مبرمَجة باستخدام أداة تعديل نماذج التشغيل الآلي في Google Home Developer Console. تتضمّن نماذج التشغيل الآلي جوهر منطق النص البرمجي، مع الإشارة إلى أنواع الأجهزة، وليس أجهزة معيّنة.
باستخدام أداة تعديل النصوص البرمجية للتشغيل الآلي في Google Home على الويب، يتمكّن المستخدمون من استخدام نموذج مبرمَجة لإنشاء نسخة افتراضية مخصّصة تعمل على الأجهزة المحدّدة في منازلهم. بعد الحفظ، يظهر المثيل ضمن سلاسل إجراءات المنزل في تطبيق Google Home (GHA).
3- التخطيط لنموذج التشغيل الآلي
عند إنشاء عملية تشغيل آلي، يبدأ المرء بالتفكير في المشكلة التي يحاول الشخص حلها، وما الذي سيفعله التشغيل الآلي لحل المشكلة. ويشمل ذلك بعض الاعتبارات:
- الأجهزة التي تريد تشغيلها تلقائيًا
- نوع إجراء التفعيل (أو الحدث) الذي من المفترض أن يؤدي إلى تنفيذ التشغيل الآلي
- ما هي الشروط الإضافية، إن وُجدت، التي تتحكّم في تشغيل التشغيل الآلي بعد تفعيله أم لا.
- الإجراءات التي سيتم تنفيذها
لأغراض هذا الدرس التطبيقي حول الترميز، ستنفّذ عملية التشغيل الآلي شيئَين:
- تشغيل ضوء في وقت محدَّد
- أطفئ نفس المصباح في وقت محدد.
ومع أخذ ذلك في الاعتبار، تكون جاهزًا لفتح محرِّر النماذج وكتابة عملية التشغيل الآلي.
4. كتابة نموذج التشغيل الآلي
تتمّ كتابة عمليات التشغيل الآلي بطريقة تعريفية باستخدام لغة تسلسل بيانات YAML.
يشمل نموذج التشغيل الآلي ثلاثة أقسام أساسية:
- البيانات الوصفية: اسم عملية التشغيل الآلي ووصف لوظائفها واختياريًا بعض العلامات المستخدَمة لتصنيف عملية التشغيل الآلي. الكلمات الرئيسية هي:
- الإضاءة والمقابس
- المناخ والطاقة
- الأمان والوعي
- الترفيه
- الأجهزة وغير ذلك
- الإدخال - يحدد نوع الجهاز(الأجهزة) الذي تريد التشغيل الآلي التحكم فيه. ويستخدم محرّك التشغيل الآلي هذه المعلومات لمعرفة أنواع الإجراءات الصالحة للأجهزة المعنيّة.
- قواعد التشغيل الآلي: لتحديد منطق بدء التشغيل الآلي وسلوكه
هذا هو نموذج التشغيل الآلي الذي ستعمل عليه:
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
واحدًا لإعلام عملية التشغيل الآلي بوقت بدء التشغيل الآلي.
محرِّر النماذج
محرِّر نماذج عمليات التشغيل الآلي هي الأداة التي تستخدمها لكتابة نماذج التشغيل الآلي.
- انتقِل إلى وحدة تحكّم المطوّرين في Google Home.
- سجِّل الدخول في تطبيق Google Home باستخدام الحساب نفسه الذي تم إعداد جهازك به.
- أنشِئ مشروعًا حاليًا أو اختَره.
- ضمن عمليات التشغيل الآلي، انقر على تطوير.
- انقر على إنشاء نموذج.
- نسخ "المصباح المجدوَل" نموذج التشغيل الآلي.
- لصق "المصباح المجدوَل" نموذج التشغيل الآلي في محرِّر النماذج.
- انقر على التحقق من الصحة. قم بحل أي أخطاء قد تظهر واستمر في التحقق من الصحة وإصلاحها حتى لا تظهر أي أخطاء.
- انقر على حفظ لحفظ النموذج.
5- اختبار النموذج
يمكنك الآن اختبار النموذج في وحدة التحكم.
- يُرجى التأكّد من توصيل المصباح وظهوره في تطبيق Google Home.
- إذا كان المصباح مضاءً، عليك إطفاؤه.
- انتقِل إلى وحدة تحكّم المطوّرين في Google Home.
- افتح المشروع الذي أنشأت فيه النموذج.
- اختَر عمليات التشغيل الآلي، ثم على علامة التبويب اختبار.
- انقر على فتح بجانب "المصباح المجدوَل". نموذج التشغيل الآلي.
- اختَر البنية التي تريد اختبار النموذج فيها، ثم انقر على التالي.
- في محرِّر InputValue، حدِّد اسم المصباح. على سبيل المثال، إذا كان المصباح يُسمى "مصباح المكتب - المكتب"، عليك اختيار
Desk light - Office
من القائمة المنسدلة التي تظهر عند النقر على يسارlights
. أو يمكنك كتابة اسم الجهاز. - في محرِّر InputValue أيضًا، حدِّد وقت
time_on
للإشارة إلى وقت، بخمسة دقائق في المستقبل، وغيِّر الوقتtime_off
إلى وقت بعدtime_on
بفترة قصيرة. - عند الانتهاء، من المفترض أن يظهر محرِّر InputValue على النحو التالي:
inputValue: #add value the_light: Desk light - Office #add value time_off: 11:45 am #add value time_on: 11:40 am
- انقر على تفعيل الاختبار.
- الانتظار حتى انتهاء وقتَي التفعيل. يجب أن يضيء الضوء ثم ينطلق في الأوقات المحددة.
بعد اختبار النموذج بنجاح، ستعلم أن التشغيل الآلي سليم من الناحية الوظيفية.
6- تهانينا
لقد أنشأت نموذج تشغيل آلي بنجاح. رائع!
في هذا الدرس التطبيقي حول الترميز، تعلمتَ كيفية:
- طريقة تصميم نموذج التشغيل الآلي وكتابةه.
- كيفية اختباره في Google Home Developer Console.
الخطوات التالية
في هذا الدرس التطبيقي حول الترميز، قمت بإنشاء عملية تشغيل آلي بسيطة للغاية. بإمكان عمليات التشغيل الآلي إنجاز مهام أكثر من جدولة تبديل الإضاءة. بعد أن فهمت أساسيات إنشاء نموذج التشغيل الآلي واختباره، يمكنك محاولة إنشاء نماذج مبرمَجة لأنواع أخرى من الأجهزة باستخدام إجراءات تفعيل وشروط وإجراءات مختلفة.
محتوى إضافي للقراءة
للاطّلاع على مزيد من المعلومات عن عمليات التشغيل الآلي في Google Home، يمكنك الاطّلاع على المستندات المرجعية الخاصة بهذه العمليات: