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

قبل البدء في استخدام Automation API، عليك تصميم عمليات التشغيل الآلي.

حدِّد المَعلمات التالية لكل عملية تشغيل آلي:

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

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

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

في ما يلي أنواع مختلفة من عمليات التشغيل الآلي التي يمكن أن ينشئها تطبيق باستخدام واجهات برمجة التطبيقات 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 لنظام التشغيل Android وDevice API لنظام التشغيل Android وDiscovery API.

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

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