कुछ Matter डिवाइसों में एक ही तरह के कई एंडपॉइंट होते हैं. अन्य Matter डिवाइसों में हैरारकी होती है. इनमें एंडपॉइंट, अन्य एंडपॉइंट के अंदर नेस्ट किए जाते हैं. Home APIs में, दोनों तरह के डिवाइसों को मल्टीपार्ट डिवाइस कहा जाता है.
फ़्लैट व्यू
Home APIs के 1.8 वर्शन से पहले, Home APIs में कई हिस्सों वाले डिवाइसों को अलग-अलग और एक-दूसरे से अलग डिवाइसों के सेट के तौर पर दिखाया जाता था. इसे फ़्लैट प्रज़ेंटेशन कहा जाता है.
उदाहरण के लिए, चार स्विच वाला एक वॉल पैनल डिवाइस, Home APIs में चार अलग-अलग और एक-दूसरे से अलग डिवाइसों के तौर पर दिखता है. साथ ही, रेफ़्रिजरेटर जैसे किसी क्रमबद्ध Matter डिवाइस को Home APIs में डिवाइसों के सेट के तौर पर दिखाया जा सकता है. इसमें हर डिवाइस, किसी एक एंडपॉइंट से जुड़ा होता है.
चार स्विच वाले वॉल पैनल का फ़्लैट रिप्रज़ेंटेशन.
फ़्रिज का फ़्लैट प्रज़ेंटेशन
मल्टीपार्ट रिप्रज़ेंटेशन
Home APIs के 1.8 वर्शन से, कई हिस्सों वाले डिवाइस को एपीआई में एक डिवाइस के तौर पर दिखाया जा सकता है. इस सुविधा को चालू करने के लिए, Home इंस्टेंस पर devices() तरीके को कॉल करें और 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) }