مقاصد خانه هوشمند، اشیاء پیامرسان سادهای هستند که توصیف میکنند چه اقدامی smart home انجام میشود، مانند روشن کردن چراغ یا پخش صدا به بلندگو.
تمام مقاصد smart home در فضای نام action.devices
موجود است و شما باید برای آنها تکمیل کنید. هر زمان که Google Assistant هدفی را برای تحقق ارسال میکند، نشانه دسترسی کاربر به OAuth 2 شخص ثالث در سرصفحه مجوز ارسال میشود.
اینها اهداف smart home پشتیبانی شده هستند:
همگام سازی
هدف 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 استفاده می شود.
هنگامی که کاربران وضعیت دستگاه را جویا می شوند، برای پاسخ به سؤالی مانند Hey Google، چه چراغ هایی در آشپزخانه روشن است؟ , Assistant یک هدف action.devices.QUERY
را برای انجام شما ارسال می کند.
برای بهترین تجربه کاربری، باید وضعیت گزارش را پیاده سازی کنید تا به طور فعال وضعیت فعلی دستگاه های کاربر را مستقیماً به Google Home Graph گزارش دهید. برای مثال، این به Assistant اجازه میدهد بفهمد که آیا کاربر شما یک چراغ هوشمند را با سوئیچ نور فیزیکی روشن کرده است یا خیر.
اجرا کنید
هدف action.devices.EXECUTE
برای ارائه دستوراتی برای اجرا در دستگاه های smart home استفاده می شود.
وقتی کاربران دستوراتی را به دستگاههای دارای Assistant ارسال میکنند، اجرای شما یک هدف action.devices.EXECUTE
برای انجام شما دریافت میکند که عملکرد و دستگاههایی را که باید بر اساس آن عمل کنید، توصیف میکند. کاربر میتواند با دستوری مانند Hey Google، چراغهای اتاق نشیمن من را روشن کن، عملکردی را روی دستگاهی اجرا کند.
قطع کردن
هدف action.devices.DISCONNECT
فعال میشود تا زمانی که کاربری حساب برنامه را از Assistant لغو پیوند کند، به شما اطلاع میدهد. پس از دریافت یک هدف action.devices.DISCONNECT
، نباید وضعیت را برای دستگاه های این کاربر گزارش کنید.