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

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

وبوجه عام:

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

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

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

  يمكنك الرجوع إلى قائمة طُرز الأجهزة هذه والإجراءات والمشغّلات المحدّدة التي تتوافق معها في Automations API.

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

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

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

• بعض السمات لها متطلبات أساسية:

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

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