כוונות

כוונה לבית חכם היא אובייקט פשוט של הודעה שמתאר איזו אינטגרציה של Cloud-to-cloud צריך לבצע, למשל להדליק אור או להפעיל אודיו ברמקול.

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

אלה הכוונות הנתמכות:smart home

סנכרון

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

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

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

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

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

במהלך ההגדרה של הפעלת הזמנות מקומיות, פלטפורמת Local Home בודקת את התגובה SYNC מהפעלת ההזמנות בענן של smart home הפעולה שלכם. כדי לקבל מידע נוסף על שינוי התגובה של SYNC כדי לתמוך באספקת מוצרים מקומית, אפשר לעיין במאמר עדכון התגובה של SYNC באספקת מוצרים בענן.

QUERY

הכוונה action.devices.QUERY משמשת לשאילתת המצב הנוכחי של מכשירי smart home.

כשמשתמשים שואלים על סטטוס המכשיר, כדי לענות על שאלה כמו Ok Google, אילו אורות דולקים במטבח?, ‫Assistant שולח/ת כוונת action.devices.QUERY אל מרכז הבקשות.

תרשים זרימה של כוונת שאילתה
איור 3: כוונת שאילתה

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

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

EXECUTE

הכוונה action.devices.EXECUTE משמשת למתן פקודות לביצוע במכשירי smart home.

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

דיאגרמת זרימה של אובייקט Intent מסוג EXECUTE
איור 5: אובייקט Intent מסוג EXECUTE

התנתקות

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

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