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

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

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

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

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

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

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

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

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

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

لذلك، سيبدو مسار التنفيذ على النحو التالي:

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

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

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

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

تسلسل التنفيذ:

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	السمات التي تتوافق مع الأجهزة ما هي عبارات التفعيل والطلبات المتاحة لهذه السمات؟ ما هي القيود المفروضة على مَعلمات هذه الأوامر؟