מכשירים מרובי חלקים ב-iOS

חלק ממכשירי Matter מורכבים מכמה נקודות קצה עם אותו סוג מכשיר. מכשירי Matter אחרים הם היררכיים, עם נקודות קצה שמוטמעות בתוך נקודות קצה אחרות. ב-Home APIs, שני סוגי המכשירים נקראים מכשירים מרובי חלקים.

ייצוג שטוח

לפני גרסה 1.8 של ממשקי ה-API של Home, מכשירים מרובי חלקים מיוצגים על ידי ממשקי ה-API של Home כקבוצה של מכשירים נפרדים שלא קשורים זה לזה. הייצוג הזה נקרא שטוח.

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

• 

  ייצוג שטוח של פנל קיר עם 4 מתגים.

  
• 

  ייצוג שטוח של מקרר

  

ייצוג של כמה חלקים

החל מגרסה 1.8 של ממשקי ה-API של Home, אפשר לייצג מכשיר מרובה חלקים בממשק ה-API כמכשיר יחיד. כדי להפעיל את ההתנהגות הזו, קוראים לשיטה devices() במופע Home ומגדירים את הפרמטר enableMultipartDevices לערך true:

let devices = try await self.home.devices(enableMultipartDevices: true).list()
    let device = devices.first { $0.id == powerStrip.device.id }
    let outlets = try await device.types.getAll(of: OnOffPluginUnitDeviceType.self)

בתרשימים הבאים אפשר לראות איך האפשרות enableMultipartDevices משפיעה על הייצוג של מכשיר מרובה חלקים בממשקי ה-API של Home:

• 

  ייצוג של לוח קיר מרובה חלקים.

  
• 

  ייצוג של מקרר שמורכב מכמה חלקים.

  

תמיד יש לכם אפשרות לקבל את הייצוג השטוח על ידי השמטת הפרמטר enableMultipartDevices או על ידי הגדרתו לערך false.

ניווט במכשיר מרובה חלקים

במכשיר מרובה חלקים, כל מופע רכיב של סוג מכשיר נקרא חלק.

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

המחלקות DeviceType מאפשרות למפתחים לעבור בין צמתי פירוט מבנה המכשיר (DT) באמצעות השיטה parts():

let outlet1 = await device.parts.getAll(of: OnOffPluginUnitDeviceType.self).first {
  $0.tags.contains(SemanticTag.CommonNumber.one)
}
let outlet3 = await device.parts.getAll(of: OnOffPluginUnitDeviceType.self).first {
  $0.tags.contains(SemanticTag.CommonNumber.three)
}

בדוגמה הבאה אפשר לראות איך ניגשים לחלקים של מכשיר מקרר:

let refrigerator: RefrigeratorDeviceType? =
   await home.devices(enableMultipartDevices: true).first { $0.id == FRIDGE_ID }
// Get different cabinets of the refrigerator
let freezer = refrigerator!.parts(type: TemperatureControlledCabinetDeviceType.self).first {
  $0.tags.contains(SemanticTag.Refrigerator.freezer)
}