অ্যান্ড্রয়েডে মাল্টিপার্ট ডিভাইস

কিছু Matter ডিভাইস একই ডিভাইস টাইপের একাধিক এন্ডপয়েন্ট নিয়ে গঠিত। অন্যান্য Matter ডিভাইসগুলো স্তরক্রমিক, যেখানে একটি এন্ডপয়েন্টের ভেতরে আরেকটি এন্ডপয়েন্ট থাকে। হোম এপিআই-গুলোতে, উভয় প্রকারের ডিভাইসকেই মাল্টিপার্ট ডিভাইস হিসেবে উল্লেখ করা হয়।

সমতল উপস্থাপনা

হোম এপিআই-এর ১.৮ রিলিজের আগে, মাল্টিপার্ট ডিভাইসগুলোকে হোম এপিআই দ্বারা পৃথক ও সম্পর্কহীন ডিভাইসের একটি সেট হিসেবে উপস্থাপন করা হতো। একে ফ্ল্যাট রিপ্রেজেন্টেশন বলা হয়।

উদাহরণস্বরূপ, চারটি সুইচ সহ একটি একক ওয়াল প্যানেল ডিভাইস হোম এপিআই-তে চারটি স্বতন্ত্র এবং সম্পর্কহীন ডিভাইস হিসাবে প্রদর্শিত হয়। এবং একটি শ্রেণিবদ্ধ Matter ডিভাইস, যেমন একটি রেফ্রিজারেটর, হোম এপিআই-তে ডিভাইসগুলির একটি সেট হিসাবে উপস্থাপিত হতে পারে, যার প্রতিটি একটি এন্ডপয়েন্টের সাথে সঙ্গতিপূর্ণ।

বহু-অংশীয় উপস্থাপনা

Home API-এর ১.৮ রিলিজ থেকে, একটি মাল্টিপার্ট ডিভাইসকে API-তে একটি একক ডিভাইস হিসেবে উপস্থাপন করা যাবে। এই আচরণটি সক্রিয় করতে, Structure , Room , বা HomeManager উপর devices() মেথডটি কল করুন এবং enableMultipartDevices প্যারামিটারটিকে true তে সেট করুন:

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

নিম্নলিখিত ডায়াগ্রামগুলি দেখায় কিভাবে enableMultipartDevices অপশনটি হোম এপিআই-তে একটি মাল্টিপার্ট ডিভাইসের উপস্থাপনাকে প্রভাবিত করে:

আপনি enableMultipartDevices প্যারামিটারটি বাদ দিয়ে অথবা এটিকে false এ সেট করে সর্বদা ফ্ল্যাট রিপ্রেজেন্টেশন পাওয়ার বিকল্পটি বেছে নিতে পারেন।

একটি বহু-অংশযুক্ত ডিভাইস নেভিগেট করুন

একটি মাল্টিপার্ট ডিভাইসের মধ্যে, একটি ডিভাইস টাইপের প্রতিটি কম্পোনেন্ট ইনস্ট্যান্সকে পার্ট বলা হয়।

ডিভাইস টাইপ বা Matter সিমান্টিক ট্যাগ ব্যবহার করে, পার্টগুলোকে সরাসরি প্যারেন্ট ডিভাইসে অথবা শ্রেণিবদ্ধভাবে কোনো পার্টে অ্যাক্সেস করা যেতে পারে। হোম এপিআই-তে DescriptorTrait.SemanticTagStruct এর মাধ্যমে সিমান্টিক ট্যাগগুলো প্রয়োগ করা হয়।

DeviceType অ্যাবস্ট্রাক্ট ক্লাসটি HasParts ইন্টারফেসটি ইমপ্লিমেন্ট করে, যা ডেভেলপারদের parts প্রপার্টি এবং part() মেথডের মাধ্যমে ডিভাইস ট্রি-তে নেভিগেট করার সুযোগ দেয়। প্রতিটি part ইনস্ট্যান্সও HasParts ইন্টারফেসটি ইমপ্লিমেন্ট করে, ফলে কোনো part-এর উপর parts() কল করলে শূন্য বা তার বেশি সংখ্যক সাব-পার্টের একটি তালিকা তৈরি হয়।

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে মাল্টি-সুইচ ডিভাইসের অংশগুলিতে অ্যাক্সেস করতে হয়:

val device =
      homeManager
        .devices(enableMultipartDevices = true)
        .itemFlow(Id(MULTI_SWITCH_DEVICE))
        .first()

// Here at top-level, we are using the homeDevice.parts() API to access flow of
// all the switches. Then we get the part ids.
val partIds =
      device
        .parts()
        .map { parts ->
          parts.filter { it.has(Switch) }.mapNotNull { it.metadata.partId }
        }
        .first()
        .toSet()

পরবর্তী উদাহরণে দেখানো হয়েছে কীভাবে একটি রেফ্রিজারেটর ডিভাইসের বিভিন্ন অংশে প্রবেশ করা যায়:

val rootDevice = homeManager.devices(true).itemFlow(Id("device@uuid1"))

// On the top level, HomeDevice provides both plural (parts)
// and singular (part) APIs.
// The parts() API returns all the parts accessible from the top level,
// including Endpoint 0 and its children.
val childParts = rootDevice.parts().first()
// childParts contain (EP0 as RootNode, EP1 as Refrigerator)

// The singular part() API accepts DeviceType and tags (optional).
val refrigerator = rootDevice.part(Refrigerator).first()

// Get the refrigerator device which in this case is just device@uuid1
val refrigeratorDevice = homeManager.devices(false).itemFlow(refrigerator.metadata.partId.deviceId)

// DeviceType uses a synchronous API for providing access to parts
val cabinets = refrigerator.parts  // [EP2, EP3]

// Get the HomeDevice for these cabinets (device@uuid2 and device@uuid3)
val cabinetDeviceIds = cabinets.map { it.metadata.partId }

// Now use the devices API with enableMultipartDevices = false.
val cabinetDevices = homeManager.devices(false)
    .map { devices ->
devices.filter { it.id in cabinetDeviceIds }
}.first()