إتاحة سمة Automation API على Android

تتيح Automation API لنظام التشغيل Android معظم السمات، ولكن قد يكون استخدام بعض السمات والأحداث والأوامر في السمة محدودًا.

للتأكّد من أنّ Automation API متوافقة مع حالة الاستخدام، ابحث في الجدول أدناه.

وبوجه عام:

• يجب تسجيل أي سمات وأنواع تريد استخدامها في تطبيقك مع واجهة برمجة التطبيقات Automation API عند بدء التشغيل. راجِع مقالة إنشاء مثيل Home.
• يمكن استخدام أيّ سمة في إجراءات التفعيل أو الشروط.
• لا يمكن استخدام Cloud-to-cloud جهاز لا يُبلغ عن حالته كعامل تشغيل في عمليات التشغيل الآلي التي تم إنشاؤها يدويًا أو من خلال الاستكشاف.

• حتى إذا كان الجهاز متوافقًا مع السمات المدرَجة هنا، قد يتم حظره من الاستخدام كمشغِّل أو إجراء في Automation API بسبب الحدود الدنيا لجودة حالة التقرير:

  • يتم حظر استخدام الأجهزة التي تقلّ فيها نسبة نجاح الإبلاغ عن الحالة عن %90 كأجهزة بدء.
  • يتم منع استخدام الأجهزة التي تقلّ نسبة نجاح تنفيذ الأوامر فيها عن %95 كإجراءات.

  يُرجى الرجوع إلى قائمة طُرز الأجهزة والمشغِّلات والإجراءات المحدّدة التي تتوافق مع واجهة برمجة التطبيقات Automations API.

• لا يمكن استخدام الأوامر إلا كإجراءات.

• لا تتوفّر بعض السمات، مثل AssistantBroadcast، إلا للاستخدام في Automation API.

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

• تتطلّب بعض السمات متطلبات مسبقة:

  • لاستخدام Time.ScheduledTimeEvent، يجب أن تحتوي البنية التي يتم فيها تشغيل التشغيل الآلي على عنوان شارع تم إعداده في Google Home app (GHA). توضِّح مقالة تغيير عنوان البريد الإلكتروني المخصّص للمنزل على Google كيفية إدخال المستخدم لعنوان الهيكل. إذا لم يتم إعداد العنوان في GHA، يتعذّر إنشاء الإجراء المبرمَج، ويظهر خطأ يتضمّن الرسالة "لا يتوافق structure مع ScheduledTimeEvent".
  • لاستخدام السمتَين AreaPresenceState أو AreaAttendanceState، على المستخدم إعداد ميزة "استشعار تواجد الأفراد في المنزل" في GHA.
  • لاستخدام السمة ObjectDetection، يجب أن يكون لدى المستخدم اشتراك نشط في Nest Aware.

تتوفّر أيضًا إصدارات مبسّطة لبعض السمات لاستخدامها في الإجراءات المبرمَجة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة السمات المبسّطة على Android.

يشير المربّع إلى أنّ الطلب غير متوافق مع عمليات التشغيل الآلي لنوع واحد أو أكثر من أنواع الأجهزة. لمزيد من المعلومات، يُرجى الاطّلاع على المهام المحظورة في الإجراءات المبرمَجة على Android.