כוונות

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

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

אלה כוונות הsmart home הנתמכות:

סנכרון

ה-intent‏ 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, what lights are on in the kitchen? Assistant שולח action.devices.QUERY כוונה לשירותי המילוי.

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

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

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

EXECUTE

הכוונה action.devices.EXECUTE משמשת לספק פקודות לביצוע במכשירי smart home.

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

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

התנתקות

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

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