برخیاز دستگاههای Matter از چندین نقطه پایانی با نوع دستگاه یکسان تشکیل شدهاند. سایر دستگاههای Matter سلسلهمراتبی هستند و نقاط پایانی در نقاط پایانی دیگر قرار دارند. در Home APIs، هر دو نوع دستگاه بهعنوان دستگاههای چندبخشی شناخته میشوند.
نمایش تخت
قبلاز نسخه ۱.۸ از Home APIs، دستگاههای چندبخشی توسط Home APIs بهعنوان مجموعهای از دستگاههای جداگانه و نامرتبط نشان داده میشوند. به این حالت، نمایش تخت گفته میشود.
برای مثال، یک دستگاه پانل دیواری با چهار کلید در ایپیآیهای Home بهعنوان چهار دستگاه مجزا و نامرتبط نشان داده میشود. و یک دستگاه سلسلهمراتبی Matter مانند یخچال ممکن است در Home APIs بهعنوان مجموعهای از دستگاهها نشان داده شود که هرکدام با یکی از نقاط پایانی مطابقت دارد.
نمایش تخت پانل دیواری ۴ کلیدی.
نمایش دوبعدی یخچال
نمایش چندبخشی
از نسخه ۱.۸ ایپیآیهای 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 تأثیر میگذارد:
نمایش چندبخشی پانل دیوار.
نمایش چندبخشی یخچال.
همیشه این گزینه را دارید که با حذف پارامتر 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) }