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

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

به طور کلی:

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

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

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

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

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

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

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

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

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