تتوافق 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.