כוונות

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

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

אלה ה-intents הנתמכים של smart home:

סנכרון

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

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

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

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

תרשים זרימה של Intent מסוג SYNC
איור 2: SYNC intent

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

QUERY

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

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

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

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

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

EXECUTE

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

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

תרשים זרימה של EXECUTE Intent
איור 5: כוונה מסוג EXECUTE

התנתקות

ה-intent‏ action.devices.DISCONNECT מופעל כדי להודיע לכם כשמשתמש מבטל את הקישור של חשבון האפליקציה אל Assistant. אחרי קבלת Intent מסוג action.devices.DISCONNECT, אין לדווח על מצב המכשירים של המשתמש הזה.

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