Android'de çok parçalı cihazlar

Bazı Matter cihazlar, aynı cihaz türüne sahip birden fazla uç noktadan oluşur. Diğer Matter cihazlar ise uç noktaların diğer uç noktaların içine yerleştirildiği hiyerarşik bir yapıya sahiptir. Home API'lerinde her iki cihaz türü de çok parçalı cihazlar olarak adlandırılır.

Düz gösterim

Home API'lerinin 1.8 sürümünden önce, çok parçalı cihazlar Home API'leri tarafından ayrı ve ilişkisiz bir cihaz grubu olarak temsil ediliyordu. Bu, düz gösterim olarak adlandırılır.

Örneğin, dört anahtarlı tek bir duvar paneli cihazı, Home API'lerinde dört ayrı ve ilişkisiz cihaz olarak görünür. Ayrıca, buzdolabı gibi hiyerarşik bir Matter cihaz, Home API'lerinde her biri uç noktalardan birine karşılık gelen bir cihaz grubu olarak temsil edilebilir.

Çok parçalı gösterim

Home API'lerinin 1.8 sürümünden itibaren çok parçalı bir cihaz, API'de tek bir cihaz olarak gösterilebilir. Bu davranışı etkinleştirmek için devices() yöntemini Structure, Room veya HomeManager üzerinde çağırın ve enableMultipartDevices parametresini true olarak ayarlayın:

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)

Aşağıdaki şemalarda, enableMultipartDevices seçeneğinin çok parçalı bir cihazın Home API'lerindeki gösterimini nasıl etkilediği açıklanmaktadır:

enableMultipartDevices parametresini atlayarak veya false olarak ayarlayarak her zaman düz gösterimi elde edebilirsiniz.

Çok parçalı bir cihazda gezinme

Çok parçalı bir cihazda, bir cihaz türünün her bileşen örneğine parça adı verilir.

Parçalara doğrudan üst cihazdan veya hiyerarşik bir şekilde cihaz türleri ya da Matter semantik etiketleri kullanılarak erişilebilir. Anlamsal etiketler, Home API'lerinde DescriptorTrait.SemanticTagStruct ile uygulanır.

DeviceType soyut sınıfı, HasParts arayüzünü uygular. Bu sayede geliştiriciler, parts özelliği ve part() yöntemi aracılığıyla cihaz ağacında gezinebilir. Her parça örneği, HasParts arayüzünü de uygular. Böylece bir parçada parts() çağrıldığında sıfır veya daha fazla alt parçanın listesi oluşturulur.

Aşağıdaki örnekte, çok anahtarlı cihazın parçalarına nasıl erişileceği gösterilmektedir:

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()

Sonraki örnekte, bir buzdolabı cihazının parçalarına nasıl erişileceği gösterilmektedir:

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()