مقاصد خانه هوشمند، اشیاء پیامرسان سادهای هستند که توصیف میکنند چه smart home Action to perform such as turn on a light or cast audio to a speaker.
تمام مقاصد smart home در فضای نام action.devices
موجود است و شما باید برای آنها تکمیل کنید. هر زمان که Google Assistant sends an intent to fulfillment, a user's third-party OAuth 2 access token is passed in the Authorization header.
اینها اهداف smart home پشتیبانی شده هستند:
همگام سازی
هدف action.devices.SYNC
برای درخواست لیست دستگاههای smart home که کاربر متصل کرده و برای استفاده در دسترس هستند، استفاده میشود.
وقتی کاربر دستگاههای خود را با Google Home app (GHA) , they also get authenticated to your cloud infrastructure. Then, Assistant receives an OAuth2 token. At this point, Assistant sends a action.devices.SYNC
intent to your fulfillment to retrieve the initial list of user devices and capabilities from your cloud infrastructure.

برای جلوگیری از لغو پیوند و پیوند مجدد حساب کاربری، میتوانید درخواست همگامسازی را به Assistant ارسال کنید. این هدف action.devices.SYNC
را برای همگامسازی فهرست دستگاهها و قابلیتها به اجرای شما ارسال میکند. برای اطلاعات بیشتر به اجرای درخواست همگام سازی مراجعه کنید.

در طول راهاندازی انجام محلی ، پلتفرم Local Home پاسخ SYNC
را از انجام عملیات ابری smart home شما بررسی میکند. برای کسب اطلاعات بیشتر در مورد نحوه تغییر پاسخ SYNC
برای پشتیبانی از انجام محلی، به به روز رسانی پاسخ SYNC در انجام ابر مراجعه کنید.
پرس و جو
هدف action.devices.QUERY
برای پرس و جو از وضعیت فعلی دستگاه های smart home استفاده می شود.
هنگامی که کاربران وضعیت دستگاه را جویا می شوند، برای پاسخ به سؤالی مانند Hey Google، چه چراغ هایی در آشپزخانه روشن است؟ , Assistant یک هدف action.devices.QUERY
را برای انجام شما ارسال می کند.

برای بهترین تجربه کاربری، باید وضعیت گزارش را پیاده سازی کنید تا به طور فعال وضعیت فعلی دستگاه های کاربر را مستقیماً به Google Home Graph . For example, this lets Assistant know if your user turned on a smart light with a physical light switch.

اجرا کردن
هدف action.devices.EXECUTE
برای ارائه دستوراتی برای اجرا در دستگاه های smart home استفاده می شود.
وقتی کاربران دستوراتی را به دستگاههای دارای Assistant ارسال میکنند، اجرای شما یک هدف action.devices.EXECUTE
برای انجام شما دریافت میکند که عملکرد و دستگاههایی را که باید بر اساس آن عمل کنید، توصیف میکند. کاربر میتواند با دستوری مانند Hey Google، چراغهای اتاق نشیمن من را روشن کن، عملکردی را روی دستگاهی اجرا کند.

قطع شدن
هدف action.devices.DISCONNECT
فعال میشود تا زمانی که کاربری حساب برنامه را از Assistant لغو پیوند کند، به شما اطلاع میدهد. پس از دریافت یک هدف action.devices.DISCONNECT
، نباید وضعیت را برای دستگاه های این کاربر گزارش کنید.