دستگاه‌های چندبخشی در iOS

برخی‌از دستگاه‌های Matter از چندین نقطه پایانی با نوع دستگاه یکسان تشکیل شده‌اند. سایر دستگاه‌های Matter سلسله‌مراتبی هستند و نقاط پایانی در نقاط پایانی دیگر قرار دارند. در Home APIs، هر دو نوع دستگاه به‌عنوان دستگاه‌های چندبخشی شناخته می‌شوند.

نمایش تخت

قبل‌از نسخه ۱.۸ از Home APIs، دستگاه‌های چندبخشی توسط Home APIs به‌عنوان مجموعه‌ای از دستگاه‌های جداگانه و نامرتبط نشان داده می‌شوند. به این حالت، نمایش تخت گفته می‌شود.

برای مثال، یک دستگاه پانل دیواری با چهار کلید در ای‌پی‌آی‌های Home به‌عنوان چهار دستگاه مجزا و نامرتبط نشان داده می‌شود. و یک دستگاه سلسله‌مراتبی Matter مانند یخچال ممکن است در Home APIs به‌عنوان مجموعه‌ای از دستگاه‌ها نشان داده شود که هرکدام با یکی از نقاط پایانی مطابقت دارد.

  • نمونه پانل دیواری با چند کلید که نمایش Matter بومی و پردازش مسطح Home API را نشان می‌دهد

    نمایش تخت پانل دیواری ۴ کلیدی.

  • مثال یخچال که نمایش بومی Matter و
          بازپرداخت تخت Home API را نشان می‌دهد

    نمایش دوبعدی یخچال

شکل ۱: نمونه‌های پرداز مسطح

نمایش چندبخشی

از نسخه ۱.۸ ای‌پی‌آی‌های Home، دستگاه چندبخشی می‌تواند به‌عنوان یک دستگاه واحد در ای‌پی‌آی نشان داده شود. برای فعال کردن این رفتار، روش devices() را در نمونه Home فراخوانی کنید و پارامتر enableMultipartDevices را روی true تنظیم کنید:

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

نمودارهای زیر نشان می‌دهند که گزینه enableMultipartDevices چگونه بر نمایش دستگاه چندبخشی در Home APIs تأثیر می‌گذارد:

  • نمونه پانل دیواری با چند کلید که نمایش Matter بومی و پردازش چندبخشی Home API را نشان می‌دهد

    نمایش چندبخشی پانل دیوار.

  • نمونه یخچال که نمایش Matter بومی و بازپرداخت چندبخشی Home API را نشان می‌دهد

    نمایش چندبخشی یخچال.

شکل ۲: نمونه‌های پرداز چندبخشی

همیشه این گزینه را دارید که با حذف پارامتر enableMultipartDevices یا تنظیم آن روی false، نمایش مسطح را دریافت کنید.

در دستگاه چندبخشی، هر نمونه مؤلفه از نوع دستگاه بخش نامیده می‌شود.

می‌توان مستقیماً به قطعات در دستگاه اصلی یا قطعه‌ای به‌صورت سلسله‌مراتبی، بااستفاده از انواع دستگاه یا برچسب‌های معنایی Matter دسترسی پیدا کرد. برچسب‌های معنایی در Home APIs با SemanticTag پیاده‌سازی می‌شوند.

کلاس DeviceType به توسعه‌دهندگان اجازه می‌دهد تا ازطریق روش 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)
}