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

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

به طور کلی:

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

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

    به این لیست از مدل‌های دستگاه و شروع‌کننده‌ها و اقدامات خاصی که برای API اتوماسیون پشتیبانی می‌کنند، مراجعه کنید.

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

  • برخی از ویژگی‌ها، مانند AssistantBroadcast ، فقط برای استفاده در Automation API در دسترس هستند.

  • دستور okGoogle یک دستور در سطح ساختار است و می‌تواند برای خودکارسازی هر دستگاهی در ساختار مورد استفاده قرار گیرد. با این حال، یک برنامه Home API ممکن است به هر دستگاهی دسترسی نداشته باشد. برای مشاهده نحوه اعمال مجوزها در موارد مختلف، به مجوزهای OkGoogle مراجعه کنید.

  • برخی از صفات پیش‌نیازهایی دارند:

    • برای استفاده از Time.ScheduledTimeEvent ، ساختاری که اتوماسیون در آن اجرا می‌شود باید دارای آدرس خیابانی باشد که در Google Home app (GHA) تنظیم شده باشد. تغییر آدرس خانه گوگل توضیح می‌دهد که چگونه یک کاربر می‌تواند آدرس ساختار را وارد کند. اگر آدرس در GHA تنظیم نشده باشد، ایجاد اتوماسیون با شکست مواجه می‌شود و خطایی با پیام "The ScheduledTimeEvent is not supported by the structure ." نمایش داده می‌شود.
    • برای استفاده از ویژگی‌های AreaPresenceState یا AreaAttendanceState ، کاربر باید حسگر حضور را در GHA تنظیم کند.
    • برای استفاده از ویژگی ObjectDetection ، کاربر باید اشتراک فعال Nest Aware داشته باشد.

نسخه‌های ساده‌شده‌ای از برخی ویژگی‌ها نیز برای استفاده در اتوماسیون‌ها موجود است. برای اطلاعات بیشتر، به ویژگی‌های ساده‌شده در اندروید مراجعه کنید.