ממשקי Google Home API ל-Android מספקים ממשק API מאוחד שמאפשר למפתחים לבצע אינטראקציה עם מצב הישויות בבית של המשתמש. הישויות האלה יכולות לתאר מכשירים ומידע שאינו קשור למכשירים, שמשויכים למבנה ולחדרים של המשתמש.
ממשקי ה-API של Home מגדירים את הישויות הבאות שמשתמש יכול ליצור איתן אינטראקציה:
- מבנים מייצגים בית שמכיל חדרים ומכשירים.
- חדרים הם חלק ממבנה ומכילים מכשירים.
- מכשירים מטמיעים מאפיינים שמכילים תכונות, תואמים לסוגים, משדרים אירועים ומגיבים לפקודות.
- פעולות אוטומטיות הן חלק מהמבנה, והן משתמשות במטא-נתונים של הבית ובמכשירים כדי לבצע משימות בבית באופן אוטומטי.
איור 1 מציג את הארכיטקטורה הזו:
סוגי מכשירים ב-Home API יכולים להיות מגובים על ידי Matter, תקן פתוח לבית חכם, או להיות מכשיר Cloud-to-cloud במערכת האקולוגית של Google Home. יכול להיות שסוגים מסוימים של מכשירים יכללו פונקציונליות משני הסוגים. מידע נוסף מופיע במאמר סוגי מכשירים נתמכים ב-Android.
ב-Matter, הפונקציונליות של המכשיר מקובצת לפי אשכולות, שמיוצגים בממשקי ה-API של Home כMatterתכונות סטנדרטיות. ממשקי ה-API של Home תומכים בקבוצה הסטנדרטית של אשכולות Matter כפי שמוגדר במפרט Matter הנוכחי.
במערכת האקולוגית של Google Home, הפונקציונליות של המכשירים מקובצת לפי מאפיינים של בית חכם, שמיוצגים בממשקי ה-API של Home כמאפיינים של בית חכם של Google. ממשקי ה-API של Home תומכים בקבוצת המאפיינים של הבית החכם כפי שהוגדרו בתוכנית Cloud-to-cloud.
יש גם מאפיינים אחרים, כמו אשכולות ספציפיים ליצרן ומאפייני פלטפורמה. מידע נוסף על מודל הנתונים ב-Android
מערכת אקולוגית
המערכת האקולוגית של Google Home מספקת בסיס יעיל לבנייה, לניהול, לאבטחה ולשילוב של חוויות בית חכם. באיור 2 מוצג אופן הפעולה המשותף של כל הרכיבים.
המערכת האקולוגית כוללת את Google Automation Engine שמאחסן ומריץ פעולות אוטומטיות, שמאפשרות לבצע אוטומציה של משימות והגדרות מכשירים בבית.
ממשקי ה-API של Home משתמשים ב-OAuth 2.0 כדי להעניק גישה למכשירים במבנה. פרוטוקול OAuth מאפשר למשתמש להעניק הרשאה לאפליקציה או לשירות בלי לחשוף את פרטי הכניסה שלו.
הכלי Google Home Developer Console משמש לניהול כל השלבים של פרויקט Home APIs, החל מאימות המותג, דרך פיתוח, בדיקה ואישור, ועד להשקה. היא מייעלת את תהליך הפיתוח ומספקת כלים חזקים והפצה דרך הסביבה של Google Home.
שפה
ממשקי ה-API של Home ל-Android כתובים ב-Kotlin ומספקים ממשק אידיומטי של Kotlin שמשתמש ב-Flow כדי לנהל את המצב והמינוי. הגישה הזו מספקת מספר יתרונות בהשוואה ל-API רגיל למינויים.
מומלץ לעיין במסמכי התיעוד של Kotlin בנושאים הבאים, אם עדיין לא עשיתם זאת: קורוטינות, זרימה ו-Jetpack Compose:
- פיתוח אפליקציות ל-Android באמצעות Kotlin
- לימוד Kotlin ל-Android
- שגרות משנה (coroutines) ב-Kotlin ב-Android. ה-codelabs הספציפיים האלה עשויים להיות שימושיים:
- Kotlin flows on Android and more specifically, StateFlow.
- State ו-Jetpack Compose, במיוחד הפונקציה
collectAsStateWithLifecycle(). הפונקציה הזו מנהלת באופן אוטומטי את ההרשמה לזרימות ואת ביטול ההרשמה מהן, בהתאם לכך שממשק המשתמש שמציג את המצב נמצא בפועל בחזית או לא. - אם אתם עובדים עם Automation API, כדאי לקרוא על Kotlin type-safe builders כדי להבין איך Automation DSL פועל.
מזהים של ישויות
לכל ישות בממשקי ה-API של Home יש מזהה שמייצג את המזהה הראשי שלה. המזהה הזה הוא מזהה ייחודי ויציב שלא ישתנה לעולם במהלך חיי הישות. אפשר להשתמש במזהה הזה כדי לשמור אובייקטים במטמון או כדי לבדוק אם הם זהים, כי המטא-נתונים של ישות יכולים להשתנות.
בממשק של HasId מוסבר אילו ישויות כוללות מזהה.
מיפוי מונחים
המיפוי של ישויות בממשקי ה-API של Home למושגים Matter ו-Cloud-to-cloud הוא כדלקמן:
| Home APIs | Matter | Cloud-to-cloud |
|---|---|---|
| תכונה | אשכול | תכונה |
| מאפיין | מאפיין | מאפיין, מצב |
| פקודה | פקודה | פקודה |
| אירוע | אירוע | תגובה להמשך טיפול, התראה |