כוונות

כוונות לבית חכם הן אובייקטים פשוטים להעברת הודעות שמתארים איזו פעולה smart home לבצע, כמו להדליק נורה או להפעיל Cast של אודיו לרמקול.

כל ה-Intents מסוג smart home כלולים ב- action.devices, וצריך למלא את ההזמנות בשבילו. בכל זמן Google Assistant שולח Intent למילוי הזמנות, אסימון גישה של OAuth 2 של צד שלישי מועבר בכותרת Authorization.

אלה ה-Intents הנתמכים של smart home:

סנכרון

ה-Intent action.devices.SYNC משמש לבקשת רשימה של smart home מכשירים שהמשתמש חיבר ונמצא זמין לשימוש.

כשמשתמש מגדיר את המכשירים שלו באמצעות Google Home app (GHA), הוא גם לעבור אימות בתשתית הענן שלכם. לאחר מכן: הדומיין Assistant מקבל אסימון OAuth2. בשלב הזה, Assistant שולח Intent מסוג action.devices.SYNC אל כדי לאחזר את הרשימה הראשונית של מכשירי המשתמש והיכולות של בתשתית הענן שלכם.

האיור הזה מציג את האינטראקציה בין התשתית של Google ועל התשתית של השותפים. בתשתית של Google יש רשימת השותפים שזמינים לאפליקציית הלקוח של Assistant, ואז עובר לתשתית של השותף כדי להשלים את אימות OAuth. פרוטוקול OAuth האימות בצד השותף הוא WebView להגדרת שותף, WebView של OAuth, הגדרות ותנאים אופציונליים, ושירותי ענן של שותפים. בתשתית של השותפים, לאחר מכן, היא מחזירה את פרטי הכניסה ל-OAuth לאפליקציית הלקוח של Assistant. השותף שירותי הענן שולחים מכשירים ויכולות זמינים לשירותי Assistant, ששומר את המידע ב-Home Graph.
איור 1: האינטראקציה בין Google לשותף תשתית

כדי להימנע מביטול הקישור של חשבון המשתמש ומקישור מחדש שלו, אפשר לשלוח בקשה לסנכרון. אל Assistant. הפעולה הזו שולחת את ה-Intent action.devices.SYNC למילוי ההזמנות כדי לסנכרן את רשימת המכשירים והיכולות. צפייה הטמעה של בקשות סנכרון למידע נוסף מידע.

תרשים זרימה של Intent של סנכרון
איור 2: כוונה לסנכרון

במהלך ההגדרה של מילוי הזמנות מקומי, פלטפורמת 'בית מקומי' בודקת את התגובה SYNC מילוי הבקשה של הפעולה בענן לגבי הפעולה smart home. כדי לשנות את התשובה של SYNC כך שתתמוך במילוי הזמנה מקומית: עדכון תגובת הסנכרון במילוי האוטומטי של הענן.

QUERY

אובייקט ה-Intent action.devices.QUERY משמש לשליחת שאילתות לגבי המצב הנוכחי מתוך smart home מכשירים.

כאשר משתמשים שואלים שאלות על סטטוס המכשיר, כדי לענות על שאלה כמו Ok Google, what lights are on the kitchen?, Assistant שולח Intent מסוג action.devices.QUERY אל

תרשים זרימה של Intent מסוג QUERY
איור 3: Intent של QUERY

כדי ליהנות מחוויית המשתמש הטובה ביותר, מומלץ להטמיע את דיווח על מצב לדיווח יזום את המצב הנוכחי של המכשירים של המשתמש ישירות Google Home Graph. לדוגמה, מאפשר לנו Assistant יכול לדעת אם המשתמש שלך הפעיל נורה חכמה באמצעות מתג אור פיזי.

דיווח על מצב המכשיר באמצעות מצב הדיווח
איור 4: דיווח על מצב המכשיר

להוציא

ה-Intent action.devices.EXECUTE משמש כדי לספק פקודות להפעלה ב-smart home מכשירים.

כשמשתמשים שולחים פקודות למכשירים באמצעות Assistant, אל מקבל הכוונה של action.devices.EXECUTE מתארת את הפעולה ואת המכשירים שעליהם יש לבצע פעולה. משתמש יכול לבצע פעולה במכשיר עם פקודה כמו Ok Google, turn on my living room lights.

תרשים זרימה של כוונת החרגה
איור 5: החרגת כוונה

התנתקות

ה-Intent action.devices.DISCONNECT מופעל כדי ליידע אותך כשמשתמש ביטל את הקישור של חשבון האפליקציה אל Assistant. אחרי שמתקבלת Intent מסוג action.devices.DISCONNECT, אין לדווח על כך המצב הנוכחי של המכשירים של המשתמש.

הקודם
סוגי המכשיר והתכונות
הבא
טיפול בהזמנות