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

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

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

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

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

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

رحلة المطوّر

واجهة برمجة التطبيقات Automation API هي جزء من رحلة تطوير أكبر. وقد تم توفيرها بعد دمج واجهات برمجة التطبيقات Structure وDevice لضمان تمكّن المستخدم من استخدام ميزة التشغيل الآلي عند الحاجة.

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.

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

تنطبق الحدود التالية على عمليات التشغيل الآلي في Home APIs:

الجدول: حدود الموارد في Automation API

المقياس	الحدّ
الحد الأقصى لعدد عمليات التشغيل الآلي لكل بنية	64
الحد الأقصى لعدد العقد لكل عملية تشغيل آلي	128
الحد الأقصى لعدد عقد التعبيرات لكل عملية آلية	64
الحد الأقصى لعدد نُسخ عمليات التشغيل الآلي لكل بنية	1024
الحد الأقصى لعدد عمليات التشغيل الآلي لكل مطوّر لكل هيكل	64
الحد الأقصى لعدد عمليات التنفيذ لكل بنية في اليوم	1024
الحد الأقصى لعدد عمليات التنفيذ لكل مطوّر لكل بنية في اليوم	128