Dispositivos multipartes en Android

Algunos Matter dispositivos se componen de varios extremos con el mismo tipo de dispositivo. Otros dispositivos Matter son jerárquicos, con extremos anidados dentro de otros extremos. En las APIs de Home, ambos tipos de dispositivos se conocen como dispositivos de varias partes.

Representación plana

Antes de la versión 1.8 de las APIs de Home, los dispositivos de varias partes se representaban en las APIs de Home como un conjunto de dispositivos separados y no relacionados. Esto se conoce como la representación plana.

Por ejemplo, un solo dispositivo de panel de pared con cuatro interruptores aparece en las APIs de Home como cuatro dispositivos distintos y no relacionados. Además, un dispositivo jerárquico Matter como un refrigerador se puede representar en las APIs de Home como un conjunto de dispositivos, cada uno correspondiente a uno de los extremos.

Representación de varias partes

A partir de la versión 1.8 de las APIs de Home, un dispositivo de varias partes se puede representar en la API como un solo dispositivo. Para habilitar este comportamiento, llama al método devices() en Structure, Room o HomeManager, y establece el parámetro enableMultipartDevices en 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)

En los siguientes diagramas, se ilustra cómo la opción enableMultipartDevices afecta la representación de un dispositivo de varias partes en las APIs de Home:

Siempre tienes la opción de obtener la representación plana si omites el parámetro enableMultipartDevices o lo configuras como false.

Navega por un dispositivo de varias partes

Dentro de un dispositivo de varias partes, cada instancia de componente de un tipo de dispositivo se denomina parte.

Se puede acceder a las partes directamente en el dispositivo superior o en una parte de forma jerárquica, mediante tipos de dispositivos o Matter semánticas tags. Las etiquetas semánticas se implementan en las APIs de Home con DescriptorTrait.SemanticTagStruct.

La DeviceType clase abstracta implementa la HasParts interfaz, lo que permite a los desarrolladores navegar por el árbol de dispositivos a través de la parts propiedad y el part() método. Cada instancia de parte también implementa la interfaz HasParts, de modo que llamar a parts() en una parte produce una lista de cero o más subpartes.

En el siguiente ejemplo, se muestra cómo acceder a las partes del dispositivo de varios interruptores:

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

En el siguiente ejemplo, se muestra cómo acceder a las partes de un dispositivo de refrigerador:

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