تصميم عملية تشغيل آلي

قبل بدء استخدام واجهة برمجة التطبيقات Automation API، عليك تصميم عمليات التشغيل الآلي.

حدِّد المَعلمات التالية لكلّ عملية مبرمَجة:

• الظروف التي يجب فيها اقتراح التشغيل الآلي على المستخدم على سبيل المثال، إذا أضاف المستخدم ثلاثة مصابيح جديدة إلى منزله، قد يكون مهتمًا بميزة التشغيل الآلي المحدّدة التي تم تصميمها للتحكّم في المصابيح.
• أنواع الأجهزة المطلوبة للتشغيل الآلي على سبيل المثال، إذا كان المستخدِم قد أضاف للتو ثلاث مصابيح جديدة إلى منزله، قد يكون مهتمًا بأحد الإجراءات المبرمَجة الخاصة للتحكّم في المصابيح. تشمل أمثلة أنواع أجهزة الإضاءة OnOffLightDevice أو ColorTemperatureLightDevice أو DimmableLightDevice أو ExtendedColorLightDevice.
• سمات السمات والأوامر المطلوبة للتشغيل الآلي، وما إذا كانت متوافقة مع واجهة برمجة التطبيقات للتشغيل الآلي
• السمات التي يجب أن تفعّل التشغيل الآلي كإجراءات تفعيل تتم مناقشة إجراءات التفعيل في مكونات التشغيل الآلي.
• شروط إضافية تحدّد ما إذا كان يجب تنفيذ الإجراء المبرمَج أم لا، والإجراءات التي يجب تنفيذها
• مسار التنفيذ للعملية المبرمَجة هل يجب تنفيذه تسلسليًا أم بالتوازي؟ هل تحتاج إلى مسارات منطقية متعددة؟

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

بعد تصميم عملية التشغيل الآلي، استخدِم Automation DSL لإنشائها. إنّ عملية المعالجة المبرمَجة التي تنشئها هي في الأساس "نموذج"، أي أنّ أيّ هياكل وأجهزة في المعالجة المبرمَجة هي عناصر نائبة ويتمّ تعبئتها بهيكل كلّ مستخدم وdevices عند "اعتماد" المعالجة المبرمَجة لاستخدامه الخاص.

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

التشغيل الآلي البسيط

لنفترض أنّك بحاجة إلى كتابة تطبيق ينشئ عملية تشغيل آلي ترفع الستائر في الساعة 8:00 صباحًا. لتحقيق ذلك، يحتاج التطبيق إلى قائمة بالستائر (الأجهزة التي تحمل نوع الجهاز WindowCoveringDevice) المتوفّرة في البنية التي تتيح عمليات التشغيل الآلي، والتي يمكن أن تقدّمها واجهة برمجة التطبيقات Discovery API.

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

وبالتالي، سيظهر تسلسل التنفيذ على النحو التالي:

1. باستخدام Discovery API، اجمع قائمة أجهزة WindowCoveringDevice.
2. إذا لم يتمّ ملء عنوان الشارع، أطلِع المستخدم على أنّه يجب عليه تقديم عنوان شارع، وأوقِف التنفيذ.
3. بخلاف ذلك، حدِّد عملية التشغيل الآلي:
   1. ابدأ التشغيل الآلي في الساعة 8:00 صباحًا.
   2. لكل ستارة من الستائر، استخدِم الأمر upOrOpen لخاصية WindowCovering.

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

تخيل تطبيقًا ينشئ عملية تشغيل آلي تؤدي إلى تشغيل أضواء وامض عند رصد حركة.

من أوّل المهام في تنفيذ هذا التطبيق هي معرفة المصابيح التي تتوفّر في منزل المستخدم باستخدام واجهة برمجة التطبيقات Discovery API. باستخدام هذه المعلومات، يمكن لتطبيقك الآن عرض الأضواء المتاحة وربما السماح للمستخدم باختيار المصابيح التي يريد أن تومض.

خطوات التنفيذ:

1. باستخدام Discovery API، يمكنك جمع قائمة الأجهزة الكهربائية المضمّنة في البنية، والتي ستكون أي أجهزة من النوع OnOffLightDevice أو ColorTemperatureLightDevice أو DimmableLightDevice أو ExtendedColorLightDevice.
2. يجب توفير طريقة لاختيار الأضواء التي تومض، ربما من خلال لوحة ملف شخصي مخصّصة.
3. حدِّد عملية التشغيل الآلي:
   1. يمكنك بدء التشغيل الآلي كلما غادر أحد الأشخاص الموقع أو وصل إليه، من خلال مراقبة AreaPresenceState.
   2. إذا كان الرمز presenceState يشير إلى أنّ البنية مشغولة، وميِّز الأضواء التي اخترتها.

التشغيل الآلي العام

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

قد تطلب العملية المبرمَجة من المستخدم أولاً اختيار بنية.

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

يمكن للمستخدم اختيار الأجهزة وأدوات البدء والأوامر التي يريد استخدامها، وسيرشده الإجراء المبرمَج خلال عملية تجميع أحد الإجراءات المبرمَجة.

عندما تصبح جميع خيارات المستخدم وقراراته نهائية، ستبدأ عملية التشغيل الآلي في توليدها وحفظها في البنية التي اختارها.

على مستوى عالٍ، يجب أن تجمع هذه العملية المبرمَجة عدة مجموعات من البيانات عن منزل المستخدم باستخدام Structure API وDevice API وDiscovery API.

الجدول 1: واجهات برمجة تطبيقات Home والمعلومات التي يمكن أن تقدّمها

واجهة برمجة التطبيقات	معلومات
واجهة برمجة التطبيقات Structure API	التصاميم المتاحة الغرف المضمّنة في البنية
Device API	الأجهزة المضمّنة في البنية المحدّدة مكان توفّر هذه الأجهزة (أي غرفة)
Discovery API	السمات المتوافقة مع الأجهزة الأوامر والطلبات المتاحة لهذه السمات القيود المفروضة على مَعلمات هذه الأوامر