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

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

وبوجه عام:

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

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

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

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

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

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

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

• تتطلّب بعض السمات استيفاء شروط مسبقة:

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

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