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

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

وبوجه عام:

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

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

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

  يُرجى الرجوع إلى هذه القائمة بنماذج الأجهزة وإجراءات التفعيل والإجراءات المحدّدة التي تتيحها Automation API.

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

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

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

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

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

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