כוונות

הפניות לבית חכם הן אובייקטים פשוטים של הודעות שמתארים איזו אינטגרציה לבצע, כמו הדלקת אור או הפעלת Cast של אודיו לרמקול.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 אל מרכז הבקרה כדי לסנכרן את רשימת המכשירים והיכולות. מידע נוסף זמין במאמר הטמעה של סנכרון בקשות.

תרשים זרימה של כוונת 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 שלכם מקבל כוונה (intent) של action.devices.EXECUTE אל ה-fulfillment שלכם, שמתארת את הפעולה ואת המכשירים שעליהם צריך לפעול. משתמש יכול לבצע פעולה במכשיר באמצעות פקודה כמו Ok Google, turn on my living room lights.

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

התנתקות

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

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