כוונות

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

כל הכוונות 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 של SYNC
איור 2: כוונת SYNC

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

QUERY

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

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

תרשים זרימה של כוונת שאילתה
איור 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: כוונת הפעלה

התנתקות

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

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