پشتیبانی از ویژگی Automation API در Android

«میانای برنامه‌سازی کاربردی خودکارسازی» برای Android از اکثر مشخصه‌ها پشتیبانی می‌کند، اما پشتیبانی از برخی‌از فرمان‌ها، رویدادها، و مشخصه‌ها در یک مشخصه ممکن است محدود باشد.

به‌طور کلی:

  • هر ویژگی و نوعی که قصد دارید در برنامه‌تان با «میانای برنامه‌سازی کاربردی خودکارسازی» استفاده کنید باید در زمان مقداردهی اولیه ثبت شود. به ایجاد نمونه «خانه» مراجعه کنید.
  • می‌توان از هر شاخصه‌ای در آغازگرها یا شرایط استفاده کرد.
  • از Cloud-to-cloud دستگاهی که وضعیتشان را گزارش نمی‌کنند نمی‌توان به‌عنوان راه‌انداز در خودکارسازی‌ها استفاده کرد، چه خودکارسازی‌ها به‌صورت دستی ایجاد شده باشند چه ازطریق کشف.
  • حتی اگر دستگاهی از ویژگی‌های فهرست‌شده در اینجا پشتیبانی کند، ممکن است به‌دلیل آستانه‌های کیفیت گزارش وضعیت از استفاده به‌عنوان آغازگر یا کنش در «میانای برنامه‌سازی کاربردی خودکارسازی» مسدود شود:

    • دستگاه‌هایی که نرخ موفقیت «وضعیت گزارش» آن‌ها کمتر از ۹۰٪ باشد از استفاده به‌عنوان آغازگر مسدود می‌شوند.
    • دستگاه‌هایی که نرخ موفقیت اجرای فرمان آن‌ها کمتر از ۹۵٪ باشد، برای استفاده به‌عنوان کنش مسدود می‌شوند.

    به این فهرست مدل‌های دستگاه و آغازگرها و کنش‌های خاصی که برای API «خودکارسازی‌ها» پشتیبانی می‌کنند مراجعه کنید.

  • از فرمان‌ها فقط می‌توان به‌عنوان کنش استفاده کرد.

  • برخی‌از مشخصه‌ها، مثل AssistantBroadcast و Notification، فقط برای استفاده در «میانای برنامه‌سازی کاربردی خودکارسازی» دردسترس هستند.

  • فرمان okGoogle فرمانی در سطح ساختار است و می‌توان از آن برای خودکارسازی هر دستگاهی در ساختار استفاده کرد. بااین‌حال، برنامه «میاناهای برنامه‌سازی کاربردی خانه هوشمند» ممکن است به همه دستگاه‌ها دسترسی نداشته باشد. برای دیدن نحوه اعمال اجازه‌ها در موارد مختلف، به اجازه‌های 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 مراجعه کنید.