כוונות לבית חכם הן אובייקטים פשוטים להעברת הודעות שמתארים איזו פעולה smart home לבצע, כמו הפעלת אור או הפעלת Cast של אודיו לרמקול.
כל ה-Intents מסוג smart home נמצאים במרחב השמות action.devices
, ואתם צריכים לספק להם מילוי הזמנות. בכל פעם ש-Google Assistant שולח Intent למילוי הזמנות, אסימון הגישה של צד שלישי מסוג OAuth 2 של המשתמש מועבר בכותרת ההרשאה.
אלה ה-Intents הנתמכים של smart home:
סנכרון
Intent מסוג action.devices.SYNC
משמש כדי לבקש רשימה של smart home מכשירים שהמשתמש חובר וזמינים לשימוש.
כשמשתמשים מגדירים את המכשירים שלהם באמצעות Google Home app (GHA), הם גם עוברים אימות בתשתית הענן שלכם. לאחר מכן, הקוד Assistant מקבל אסימון OAuth2. בשלב הזה, הפקודה Assistant שולחת Intent מסוג action.devices.SYNC
למילוי ההזמנות, כדי לאחזר את הרשימה הראשונית של המכשירים והיכולות של המשתמשים מתשתית הענן.
כדי להימנע מביטול הקישור של חשבון המשתמש ומקישורו מחדש, אפשר לשלוח בקשה לסנכרון אל Assistant. הפעולה הזו שולחת את ה-Intent action.devices.SYNC
למילוי ההזמנות כדי לסנכרן את רשימת המכשירים והיכולות. למידע נוסף, ראו הטמעה של בקשה לסנכרון.
כשמגדירים את מילוי ההזמנה בחנות המקומית, פלטפורמת Home Home בודקת את התשובה SYNC
ממילוי הבקשה של הפעולה smart home בענן. במאמר עדכון תגובת סנכרון במילוי הזמנה בענן מוסבר איך לשנות את התשובה של SYNC
כדי לתמוך במילוי הזמנה מקומי.
QUERY
ה-Intent action.devices.QUERY
משמש לשליחת שאילתות על המצב הנוכחי של מכשירי smart home.
כשמשתמשים שואלים שאילתה על סטטוס המכשיר, כדי לענות על שאלה כמו
Ok Google, what lights are on the kitchen?,
Assistant שולח Intent מסוג action.devices.QUERY
למילוי ההזמנות.
כדי ליהנות מחוויית המשתמש הטובה ביותר, כדאי להטמיע את מצב הדיווח כדי לדווח באופן יזום על המצב הנוכחי של המכשירים של המשתמשים ישירות ל-Google Home Graph. לדוגמה, כך מאפשר ל-Assistant לדעת אם המשתמש הפעיל נורה חכמה באמצעות מתג אור פיזי.
להוציא
ה-Intent action.devices.EXECUTE
משמש כדי לספק פקודות להפעלה במכשירי smart home.
כשמשתמשים שולחים פקודות למכשירים עם Assistant, מילוי ההזמנה מקבל Intent מסוג action.devices.EXECUTE
, ��מתאר את הפעולה ואת המכשירים שעליהם צריך לבצע פעולה. המשתמש יכול לבצע פעולה במכשיר באמצעות פקודה כמו Ok Google, turn on my living room lights.
התנתקות
ה-Intent action.devices.DISCONNECT
מופעל כדי ליידע אתכם כשמשתמש מבטל את הקישור של חשבון האפליקציה אל Assistant.
אחרי קבלת Intent מסוג action.devices.DISCONNECT
, אסור לדווח על המצב של המכשירים של המשתמש הזה.