تتيح واجهة Automation API لنظام التشغيل Android معظم السمات، ولكن قد تكون إتاحة بعض السمات والخصائص والأحداث والأوامر محدودة.
وبوجه عام:
- يجب تسجيل أي سمات وأنواع تنوي استخدامها في تطبيقك مع Automation API عند بدء التشغيل. يُرجى الاطّلاع على إنشاء مثيل Home.
- يمكن استخدام أي سمة في إجراءات التفعيل أو الشروط.
- لا يمكن استخدام أجهزة Cloud-to-cloud التي لا تُبلغ عن حالتها كعوامل مشغّلة في عمليات التشغيل الآلي، سواء تم إنشاؤها يدويًا أو من خلال ميزة "الاكتشاف".
حتى إذا كان الجهاز يتوافق مع السمات المدرَجة هنا، قد يتم حظر استخدامه كإجراء تفعيل أو إجراء في Automation API بسبب حدود الجودة Report State:
- يتم حظر الأجهزة التي يقل معدّل نجاح حالة الإبلاغ فيها عن 90% من استخدامها كأجهزة بدء.
- سيتم حظر الأجهزة التي يقل معدّل نجاح تنفيذ الأوامر فيها عن 95% من الاستخدام كإجراءات.
يمكنك الرجوع إلى قائمة طُرز الأجهزة والإجراءات والمشغّلات المحدّدة التي تتوافق معها واجهة برمجة التطبيقات لأتمتة المنزل.
لا يمكن استخدام الأوامر إلا كإجراءات.
تتوفّر بعض السمات، مثل
AssistantBroadcast، للاستخدام في Automation API فقط.الأمر
okGoogleهو أمر على مستوى البنية ويمكن استخدامه لتنفيذ أي جهاز في البنية تلقائيًا، ولكن قد لا يتمكّن تطبيق يستخدم واجهات برمجة التطبيقات Home APIs من الوصول إلى كل جهاز. راجِع مقالة أذونات OkGoogle لمعرفة كيفية فرض الأذونات في حالات مختلفة.تتطلّب بعض السمات استيفاء شروط مسبقة:
- لاستخدام
Time.ScheduledTimeEvent، يجب أن يتضمّن المكان الذي يتم فيه تنفيذ التشغيل الآلي عنوانًا للشارع تم إعداده في Google Home app (GHA). يوضّح المقال تغيير عنوان المنزل على Google كيف يمكن للمستخدم إدخال عنوان المكان. وإذا لم يتم إعداد العنوان في GHA، سيتعذّر إنشاء التشغيل الآلي، وسيظهر خطأ مع الرسالة "لا تتوافق ScheduledTimeEvent مع structure". - لاستخدام السمتَين
AreaPresenceStateأوAreaAttendanceState، يجب أن يضبط المستخدم ميزة "استشعار تواجد الأفراد في المنزل" في GHA. - لاستخدام سمة
ObjectDetection، يجب أن يكون لدى المستخدم اشتراك نشط في Nest Aware.
- لاستخدام
تتوفّر أيضًا إصدارات مبسطة من بعض السمات لاستخدامها في عمليات التشغيل الآلي. لمزيد من المعلومات، يُرجى الاطّلاع على السمات المبسّطة على Android.