כוונות

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

כל הכוונות smart home כלולות במרחב השמות action.devices, ואתם צריכים לספק להן מילוי. בכל פעם ש-Google Assistant שולח Intent לביצוע, אסימון גישה 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 אל ה-fulfillment כדי לסנכרן את רשימת המכשירים והיכולות. מידע נוסף זמין במאמר הטמעה של סנכרון בקשות.

תרשים זרימה של 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

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

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

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

התנתקות

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

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