יכולת פעולה הדדית ב-Android

אפשר להטמיע מכשירים במערכת האקולוגית של Google Home באמצעות Cloud-to-cloud,‏ Matter או שניהם. יש סוגים של מכשירים שהם מורכבים יותר מאחרים, וקשה לפתח אותם באמצעות ממשקי ה-API של Home באופן שמאפשר אינטראקציה חלקה עם מכשירים אחרים בסביבה העסקית.

אחד האתגרים בהטמעה של חלק מסוגי המכשירים האלה הוא שהמכשירים יכולים להיות מורכבים משילובים שונים של מאפיינים. לא כל השילובים מניבים תוצאות טובות כמו אחרים. בנוסף, מיפוי מודל הנתונים Cloud-to-cloud למודל הנתונים Matter לא תמיד ברור או חד-חד-ערכי. במאמר מודל נתונים ב-Android מוסבר על מודלי הנתונים ועל המיפויים שלהם.

בדף הזה מופיע מידע נוסף על המיפוי של מודלים של נתונים למכשירים ספציפיים, וגם הנחיות לגבי המאפיינים שבהם כדאי להשתמש כדי להטמיע את סוגי המכשירים האלה.

תנור

סוג המכשיר Oven (תנור) (OvenDevice) ומאפייני הרכיבים שלו לא פשוטים להטמעה בהשוואה לסוגי מכשירים אחרים. יש כמה דרכים להטמיע תנור ב-Matter, אבל לא כל הגישות מאפשרות פעולה הדדית חלקה עם מכשירים אחרים או עם המערכת האקולוגית של Google Home.

מיפוי מאפיינים

במקום להטמיע מכשיר Matter Oven באמצעות האשכולות Oven Mode ו-On Off, מומלץ להשתמש באשכול Oven Cavity Operational State. האוסף הזה מיוצג בממשקי ה-API של Home באמצעות מאפיין OvenCavityOperationalState, ומופה למאפיין RunCycle.Cloud-to-cloud הוא מגדיר שלבים כמו 'חימום מראש', 'חימום מראש' ו'התקררות'.

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

יכול להיות שבמכשירים מסוימים מסוג Oven, רשימת השלבים תשתנה בזמן הריצה. לדוגמה, לתנורים שתומכים בחימום מראש יכולים להיות ערכים שונים ברשימת השלבים במהלך שלב החימום מראש מאשר במהלך שלבי החימום או הקירור.

הטמעה מומלצת

כמו שצוין בקטע הקודם, הטמעה של Matter Oven צריכה להטמיע את אשכול Oven Cavity Operational State, שממומש בממשקי Home API בתור מאפיין OvenCavityOperationalState.

כדי להשיג את התוצאות הכי טובות, חשוב לוודא שבCloud-to-cloud מכשיר התנור מוטמעת התכונה RunCycle ושהמצב הנוכחי מתפרסם באמצעות הגדרת המאפיין currentRunCycle. אפשר לראות את המאפיין הזה באמצעות ממשקי ה-API של Home דרך המאפיינים OvenCavityOperationalState.phaseList ו-OvenCavityOperationalState.currentPhase.

מכשיר התנור צריך גם לפרסם התראה על מחזור הפעלה על ידי עדכון המאפיינים priority, status ו-currentCycleRemainingTime של RunCycle. הדוגמה הבאה גורמת לשליחת אירוע OperationalState.OperationCompletion, ואפשר להשתמש בה כדי לציין שהתנור עבר מהמחזור pre-heating (חימום מראש) למחזור pre-heated (מחומם מראש):

{
  "currentRunCycle": [
    {
      "currentCycle": "pre-heating",
      "nextCycle": "pre-heated",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 1200,
  "currentCycleRemainingTime": 300
}

שימוש ב-Oven בפעולות אוטומטיות

כשיוצרים אוטומציה לתנור שהוטמעה באמצעות אשכול Oven Cavity Operational State, צריך להפנות למאפיין currentPhase כדי לדעת באיזה מחזור התנור נמצא:

   sequential {
    val starterNode =
      starter<_>(oven, OvenDevice, OvenCavityOperationalState /* Or OperationalState */)
    condition {
      expression = starterNode.phaseList[operationalState.currentPhase.toUInt()] equals "pre-heated"
    }
    action(speaker, SpeakerDevice) {
    command(AssistantBroadcast.broadcast("Oven Cycle Complete"))
  }
  // Additional actions here as needed
}

דוגמה מלאה מופיעה במאמר הבהוב האורות והכרזה כשהתנור מגיע לטמפרטורה שנבחרה.