نظرة عامة على 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 APIs، بما في ذلك:

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

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

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

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

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

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

رحلة المطوّر

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

  1. يخطّط المطوّر لعملية التشغيل الآلي ويحدّدها باستخدام لغة Automation DSL.
  2. يضمّن المطوّر تعريف عملية التشغيل الآلي في تطبيق Kotlin Android.
  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 اقتراح عمليات تشغيل آلي لـ Structure استنادًا إلى عوامل مثل أنواع الأجهزة المتوفّرة في المساحة.

يتم تمثيل اقتراحات التشغيل الآلي من خلال فئة AutomationSuggestion.

تتضمّن واجهة Structure واجهة HasSuggestions التي توفّر الدالة suggestions() التي تعرض مجموعة من اقتراحات التشغيل الآلي.

تهدف الطريقتان likeSuggestion() و dislikeSuggestion() إلى الربط بعناصر التحكّم في واجهة المستخدم و التي يمكن للمستخدم النقر عليها لتقديم ملاحظات.

تتيح طريقة ثالثة، clearSuggestionFeedback(), للمستخدم إزالة ملاحظاته عن عملية تشغيل آلي مقترَحة.

تؤثر ملاحظات المستخدم في الاقتراحات المستقبلية.

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

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

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