כוונות

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

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

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

התנתקות

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

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