تتيح Automation API لنظام التشغيل Android معظم السمات، ولكن قد يكون استخدام بعض السمات والأحداث والأوامر في السمة محدودًا.
للتأكّد من أنّ Automation API متوافقة مع حالة الاستخدام، ابحث في الجدول أدناه.
وبوجه عام:
- يجب تسجيل أي سمات وأنواع تريد استخدامها في تطبيقك مع واجهة برمجة التطبيقات Automation API عند بدء التشغيل. راجِع مقالة إنشاء مثيل Home.
- يمكن استخدام أيّ سمة في إجراءات التفعيل أو الشروط.
- Cloud-to-cloud لا يمكن استخدام الأجهزة التي لا تُبلغ عن حالتها كعوامل تشغيل في الإجراءات المبرمَجة التي تم إنشاؤها يدويًا أو من خلال الاستكشاف.
- حتى إذا كان الجهاز متوافقًا مع السمات المدرَجة هنا، قد يتم
حظره من الاستخدام كإجراء تفعيل أو إجراء في Automation API بسببعدم استيفاء الحد الأدنى لجودة حالة التقرير:
- يتم حظر استخدام الأجهزة التي تقلّ فيها نسبة نجاح الإبلاغ عن الحالة عن% 90 كأجهزة بدء.
- يتم حظر استخدام الأجهزة التي يكون معدّل نجاح تنفيذ الأوامر فيها أقل من% 95 كإجراءات.
- لا يمكن استخدام الأوامر إلا كإجراءات.
- لا تتوفّر بعض السمات، مثل
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.