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

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

وبوجه عام:

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

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

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

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

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

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

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

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

  • لاستخدام أدوات التشغيل المستندة إلى الوقت، مثل 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.