نظرة عامة على Automation API على Android

عمليات التشغيل الآلي هي طريقة لتنفيذ المهام وإعدادات الأجهزة بشكل آلي في المنزل. تتوفّر عمليات التشغيل الآلي في منظومة Google Home المتكاملة كسلاسل إجراءات في Google Home app (GHA) ومن خلال automation script editor على Google Home for web.

أصبحت عمليات التشغيل الآلي في منظومة Google Home متوفّرة الآن من خلال واجهات برمجة التطبيقات Home APIs لنظام التشغيل Android. تستخدم هذه السلاسل المفاهيم الأساسية نفسها المستخدَمة في سلاسل إجراءات GHA وscript editor، ولكن مع ميزات وإمكانات محسّنة لا يمكن توفيرها إلا من خلال واجهات برمجة التطبيقات Home، بما في ذلك:

  • إمكانية الوصول إلى جميع سمات Matter العادية وsmart home لجهاز معيّن، كما هو موضّح في واجهات برمجة التطبيقات لمنزل Google
  • إتاحة تدفّقات التنفيذ المتسلسلة والمتوازية والمحدّدة

تتم كتابة عمليات التشغيل الآلي باستخدام Automation DSL، وهي لغة خاصة بالنطاق مصمَّمة لإنشاء عمليات التشغيل الآلي في Kotlin.

يجب تسجيل أي سمات وأنواع تنوي استخدامها في تطبيقك مع واجهات برمجة التطبيقات Device & Structure أو Automation عند بدء التشغيل. اطّلِع على مقالة إعداد المنزل على Android.

إرشادات في حال ألغى المستخدم الأذونات الكاملة

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

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

رحلة المطوِّر

تمثّل Automation API جزءًا من رحلة تطوير أكبر. يأتي هذا الإجراء بعد دمج واجهات برمجة التطبيقات الخاصة بالبنية والأجهزة لضمان إمكانية استخدام التشغيل الآلي عندما يريد المستخدم ذلك.

  1. يخطّط المطوّر لعملية التشغيل الآلي ويحدّدها باستخدام Automation DSL.
  2. يضمِّن المطوّر تعريف التشغيل الآلي في تطبيق Android مكتوب بلغة Kotlin.
  3. يعرض التطبيق عمليات التشغيل الآلي للمستخدم استنادًا إلى معلومات حول أجهزته، بما في ذلك السمات والخصائص والأوامر والأحداث، التي يتم جمعها باستخدام واجهة برمجة التطبيقات Discovery API أو Device API.
    1. باستخدام Discovery API، يمكن للتطبيق إنشاء مسودة عملية تشغيل آلي مخصّصة لأنواع الأجهزة وسماتها المتوفّرة في بنية المستخدم، وذلك مع إدخال المستخدم أو بدونه.
    2. يمكن أن توفّر Device API معظم المعلومات نفسها التي توفّرها Discovery API، ولكنّها غير محسّنة لحالات استخدام التشغيل الآلي. يمكنك الاطّلاع على مقارنة بين واجهة برمجة التطبيقات Device API وواجهة برمجة التطبيقات Discovery API للحصول على مزيد من التفاصيل.
  4. ينشئ التطبيق عملية التشغيل الآلي الفعلية التي يتم ربطها بالبنية المحدّدة.
  5. التشغيل الآلي متاح الآن في بنية المستخدم ويمكن تنفيذه أو حذفه باستخدام طرق Structure API.

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

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

الحدود القصوى لاستخدام الموارد

تنطبق الحدود التالية على عمليات التشغيل الآلي في واجهات برمجة التطبيقات الخاصة بالمنزل الذكي:

الجدول: حدود موارد Automation API
المقياس الحدّ
الحد الأقصى لعدد عمليات التشغيل الآلي لكل بنية 64
الحدّ الأقصى لعدد العُقد في كل عملية تشغيل آلي 128
الحد الأقصى لعدد عُقد التعبير لكل عملية إعداد مبرمَجة 64
الحدّ الأقصى لعدد مثيلات التشغيل الآلي لكل بنية 1024
الحد الأقصى لعدد مثيلات التشغيل الآلي لكل مطوّر لكل بنية 64
الحد الأقصى لعدد عمليات التنفيذ لكل بنية في اليوم 1024
الحد الأقصى لعدد عمليات التنفيذ لكل مطوّر ولكل بنية في اليوم 128