تُعدّ عمليات التشغيل الآلي طريقة لأتمتة المهام وإعدادات الأجهزة في المنزل. أصبحت عمليات التشغيل الآلي متاحة في نظام Google Home الأساسي كسلاسل إجراءات في الـ Google Home app (GHA) ومن خلال الـautomation script editor على الـ Google Home for web.
أصبحت عمليات التشغيل الآلي في نظام Google Home الأساسي متاحة الآن من خلال واجهات برمجة التطبيقات Home APIs لنظام Android. تستخدِم هذه العمليات المفاهيم الأساسية نفسها المستخدَمة في GHA سلاسل الإجراءات في تطبيق Google Home وأداة تعديل النصوص البرمجية، ولكن مع ميزات وإمكانات محسّنة لا يمكن الحصول عليها إلا من خلال واجهات برمجة التطبيقات Home APIs، بما في ذلك:script editor
- الوصول إلى جميع Matter سمات الأجهزة القياسية و smart home لجهاز، كما هو موضّح في واجهات برمجة التطبيقات Home APIs
- إمكانية تنفيذ تدفقات التنفيذ المتسلسلة والمتوازية والمحدّدة
تتم كتابة عمليات التشغيل الآلي باستخدام لغة Automation DSL، وهي لغة خاصة بالنطاق مصمّمة لإنشاء عمليات التشغيل الآلي في Kotlin.
يجب تسجيل أي سمات وأنواع تنوي استخدامها في تطبيقك من خلال واجهات برمجة التطبيقات Device &Structure أو Automation APIs عند التهيئة. يُرجى الاطّلاع على مقالة تهيئة المنزل على Android.
إرشادات في حال إلغاء المستخدم الأذونات الكاملة
إذا ألغى المستخدم الأذونات الكاملة، ستتوقف جميع عمليات التشغيل الآلي الحالية عن العمل. أيضًا، إذا ألغى المستخدم إمكانية الوصول إلى أجهزة معيّنة، ستتوقف عن العمل المشغّلات والشروط والإجراءات المرتبطة بهذه الأجهزة.
في كل مرة يبدأ فيها التطبيق، احرص على التحقّق من أنّ الأذونات لا تزال سارية. إذا تم إلغاؤها، احرص على إزالة جميع البيانات السابقة، بما في ذلك أي بيانات مخزّنة مؤقتًا في التطبيق.
عند إلغاء إذن الوصول إلى البنية، يتم إرسال
StructureAccessRevokedEvent
إلى الخادم الخلفي السحابي. يُرجى الاطّلاع على
الأذونات الممنوحة للبنية لمعرفة
سير عمل إلغاء الأذونات من السحابة الإلكترونية الشاملة للشركاء وتطبيق الأجهزة الجوّالة.
رحلة المطوّر
تُعدّ Automation API جزءًا من رحلة تطوير أكبر. تأتي هذه الواجهة بعد دمج واجهتَي برمجة التطبيقات Structure وDevice APIs لضمان إمكانية استخدام المستخدم لعملية تشغيل آلي عندما يريد ذلك.
- يخطّط المطوّر لعملية التشغيل الآلي ويحدّدها باستخدام لغة Automation DSL.
- يضمّن المطوّر تعريف عملية التشغيل الآلي في تطبيق Kotlin Android.
- يعرض التطبيق عمليات التشغيل الآلي للمستخدم استنادًا إلى معلومات عن أجهزته، بما في ذلك السمات والخصائص والأوامر والأحداث، التي يتم جمعها باستخدام واجهة برمجة التطبيقات Discovery API أو Device API.
- باستخدام واجهة برمجة التطبيقات Discovery API، يمكن للتطبيق إنشاء مسودة عملية تشغيل آلي مخصّصة لأنواع الأجهزة والسمات المتوفّرة في بنية المستخدم، سواء مع إدخال المستخدم أو بدونه.
- يمكن أن توفّر واجهة برمجة التطبيقات Device API معظم المعلومات نفسها التي توفّرها واجهة برمجة التطبيقات Discovery API، ولكنّها غير محسّنة لحالات استخدام التشغيل الآلي. لمزيد من التفاصيل، يُرجى الاطّلاع على مقارنة بين واجهتَي برمجة التطبيقات Device API وDiscovery API.
- ينشئ التطبيق عملية التشغيل الآلي الفعلية التي يتم ربطها بالبنية المحدّدة.
- تصبح عملية التشغيل الآلي متاحة الآن في بنية المستخدم ويمكن تنفيذها أو حذفها باستخدام طرق واجهة برمجة التطبيقات Structure API.
يمكن للمستخدم إنشاء مثيلات جديدة لعملية التشغيل الآلي في أي وقت، واختيار بنية مختلفة أو، استنادًا إلى منطق التطبيق، ربما مجموعة مختلفة من الأجهزة. في كل مرة يفعل ذلك، ينشئ التطبيق مثيلاً جديدًا لعملية التشغيل الآلي.
في السيناريو الأساسي، قد تقترح على المستخدمين عملية تشغيل آلي محدّدة مسبقًا تنفّذ مهمة أساسية نسبيًا. بدلاً من ذلك، يمكنك عرض نموذج أولي لعملية تشغيل آلي يخصّصها المستخدم لتلبية احتياجاته. أو يمكنك كتابة أداة تعديل مفتوحة لعمليات التشغيل الآلي تسمح للمستخدم بإنشاء عمليات تشغيل آلي معقّدة باستخدام جميع العناصر الأساسية المتاحة في Automation API.
اقتراحات التشغيل الآلي
يمكن لواجهات برمجة التطبيقات Home APIs اقتراح عمليات تشغيل آلي لـ
Structure استنادًا إلى عوامل
مثل أنواع الأجهزة المتوفّرة في المساحة.
يتم تمثيل اقتراحات التشغيل الآلي من خلال الفئة
AutomationSuggestion.
تتضمّن واجهة Structure
واجهة HasSuggestions
التي توفّر الدالة suggestions()
التي تعرض مجموعة من اقتراحات التشغيل الآلي.
تهدف الطريقتان
likeSuggestion()
و
dislikeSuggestion()
إلى الربط بعناصر التحكّم في واجهة المستخدم
و
التي يمكن للمستخدم النقر عليها
لتقديم ملاحظات.
تتيح الطريقة الثالثة،
clearSuggestionFeedback(),
للمستخدم إزالة ملاحظاته عن عملية تشغيل آلي مقترَحة.
تؤثر ملاحظات المستخدم في الاقتراحات المستقبلية.
الحدود القصوى لاستخدام الموارد
تنطبق الحدود القصوى التالية على عمليات التشغيل الآلي في واجهات برمجة التطبيقات Home APIs:
| المقياس | الحدّ |
|---|---|
| الحد الأقصى لعدد عمليات التشغيل الآلي لكل بنية | 64 |
| الحد الأقصى لعدد العُقد لكل عملية تشغيل آلي | 128 |
| الحد الأقصى لعدد عُقد التعبير لكل عملية تشغيل آلي | 64 |
| الحد الأقصى لعدد مثيلات التشغيل الآلي لكل بنية | 1024 |
| الحد الأقصى لعدد مثيلات التشغيل الآلي لكل مطوّر لكل بنية | 64 |
| الحد الأقصى لعدد عمليات التنفيذ لكل بنية في اليوم | 1024 |
| الحد الأقصى لعدد عمليات التنفيذ لكل مطوّر لكل بنية في اليوم | 128 |