iOS पर मल्टीपार्ट डिवाइस

कुछ Matter डिवाइसों में एक ही तरह के कई एंडपॉइंट होते हैं. अन्य Matter डिवाइसों में हैरारकी होती है. इनमें एंडपॉइंट, अन्य एंडपॉइंट के अंदर नेस्ट किए जाते हैं. Home APIs में, दोनों तरह के डिवाइसों को मल्टीपार्ट डिवाइस कहा जाता है.

फ़्लैट व्यू

Home APIs के 1.8 वर्शन से पहले, Home APIs में कई हिस्सों वाले डिवाइसों को अलग-अलग और एक-दूसरे से अलग डिवाइसों के सेट के तौर पर दिखाया जाता था. इसे फ़्लैट प्रज़ेंटेशन कहा जाता है.

उदाहरण के लिए, चार स्विच वाला एक वॉल पैनल डिवाइस, Home APIs में चार अलग-अलग और एक-दूसरे से अलग डिवाइसों के तौर पर दिखता है. साथ ही, रेफ़्रिजरेटर जैसे किसी क्रमबद्ध Matter डिवाइस को Home APIs में डिवाइसों के सेट के तौर पर दिखाया जा सकता है. इसमें हर डिवाइस, किसी एक एंडपॉइंट से जुड़ा होता है.

  • कई स्विच वाले वॉल पैनल का उदाहरण, जिसमें Matter का नेटिव प्रज़ेंटेशन और Home API की फ़्लैट रेंडरिंग दिखाई गई है

    चार स्विच वाले वॉल पैनल का फ़्लैट रिप्रज़ेंटेशन.

  • रेफ़्रिजरेटर का उदाहरण, जिसमें Matter के नेटिव प्रज़ेंटेशन और Home API की फ़्लैट रेंडरिंग को दिखाया गया है

    फ़्रिज का फ़्लैट प्रज़ेंटेशन

पहली इमेज: फ़्लैट रेंडरिंग के उदाहरण

मल्टीपार्ट रिप्रज़ेंटेशन

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 में कई हिस्सों वाले डिवाइस को दिखाने के तरीके पर कैसे असर डालता है:

  • कई स्विच वाले वॉल पैनल का उदाहरण, जिसमें 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)
}