هدفهای خانه هوشمند اشیای پیامرسانی سادهای هستند که توضیح میدهند چه ادغام Cloud-to-cloud باید انجام شود، مثلاً روشن کردن چراغ یا پخش صدا در بلندگو.
همه هدفهای smart home در فضای نام action.devices قرار دارند و باید برای آنها برآوردهسازی ارائه دهید. هرگاه
Google Assistant قصدی را برای برآوردهسازی ارسال کند، کد دسترسی OAuth 2 شخص ثالث کاربر در سرصفحه «مجوز» ارسال میشود.
اینها هدفهای smart home پشتیبانیشده هستند:
SYNC
از قصد action.devices.SYNC برای درخواست فهرست دستگاههای smart home که کاربر متصل کرده است و برای استفاده دردسترس هستند استفاده میشود.
وقتی کاربری دستگاههایش را با Google Home app (GHA) راهاندازی میکند،
در زیرساخت ابری شما نیز اصالتسنجی میشود. سپس،
Assistant کد OAuth2 را دریافت میکند. در این مرحله،
Assistant قصد action.devices.SYNC را به
تحقق شما ارسال میکند تا فهرست اولیه دستگاهها و قابلیتهای کاربر را از
زیرساخت ابری شما بازیابی کند.
برای جلوگیری از قطع پیوند و بازپیوند کردن حساب کاربر، میتوانید درخواست همگامسازی به Assistant ارسال کنید. با این کار، هدف action.devices.SYNC
به تحقق شما ارسال میشود تا فهرست دستگاهها و قابلیتها همگامسازی شود. برای اطلاعات بیشتر، به
پیادهسازی همگامسازی درخواست مراجعه کنید.
درطول راهاندازی اجرای محلی،
پلاتفرم Local Home پاسخ SYNC را از
اجرای ابری smart home «کنش» شما بررسی میکند. برای کسب اطلاعات بیشتر درباره نحوه
اصلاح پاسخ SYNC برای پشتیبانی از اجرای محلی،
بهروزرسانی پاسخ SYNC در اجرای ابری را ببینید.
QUERY
از هدف action.devices.QUERY برای پرسمان وضعیت فعلی
دستگاههای smart home استفاده میشود.
وقتی کاربران وضعیت دستگاه را پرسمان میکنند، برای پاسخ دادن به سؤالی مثل
Ok Google، کدام چراغها در آشپزخانه روشن است؟،
Assistant هدف action.devices.QUERY را به تحقق شما ارسال میکند.
برای ارائه بهترین تجربه کاربری، باید Report State را پیادهسازی کنید تا وضعیت فعلی دستگاههای کاربر را مستقیماً به Google Home Graph گزارش دهید. برای مثال، این کار به Assistant اطلاع میدهد که آیا کاربر شما چراغ هوشمند را با کلید برق فیزیکی روشن کرده است یا نه.
EXECUTE
از هدف action.devices.EXECUTE برای ارائه فرمانهایی
برای اجرا در دستگاههای smart home استفاده میشود.
وقتی کاربران با Assistant به دستگاهها فرمان ارسال میکنند،
اجرای شما هدف action.devices.EXECUTE را برای اجرای شما دریافت میکند که
کنش و دستگاههایی را که باید روی آنها کنش انجام شود شرح میدهد. کاربر میتواند با فرمانی مثل Ok Google، چراغهای اتاق نشیمن را روشن کن،
کنشی را در دستگاه اجرا کند.
قطع کردن اتصال
قصد action.devices.DISCONNECT برای اطلاعرسانی به شما راهاندازی میشود
وقتی کاربری پیوند حساب برنامه را از Assistant لغو کرده باشد.
پساز دریافت هدف action.devices.DISCONNECT، نباید وضعیت دستگاههای این کاربر را گزارش کنید.