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

Automation API for Android از اکثر ویژگی‌ها پشتیبانی می‌کند، اما پشتیبانی از برخی مشخصه‌ها، رویدادها، و فرمان‌ها در یک ویژگی ممکن است محدود باشد.

به‌طور کلی:

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

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

    به این فهرست مدل‌های دستگاه و آغازگرها و کنش‌های خاصی که برای 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 را ببینید.