Urządzenia wieloczęściowe na Androidzie

Niektóre urządzenia Matter składają się z wielu punktów końcowych tego samego typu. Inne urządzenia Matter są hierarchiczne, a punkty końcowe są zagnieżdżone w innych punktach końcowych. W interfejsach Home API oba rodzaje urządzeń są nazywane urządzeniami wieloczęściowymi.

Płaska reprezentacja

Przed wersją 1.8 interfejsów Home API urządzenia wieloczęściowe są reprezentowane przez interfejsy Home API jako zestaw oddzielnych, niepowiązanych urządzeń. Jest to tzw. reprezentacja płaska.

Na przykład pojedynczy panel ścienny z 4 przełącznikami jest widoczny w interfejsach Home API jako 4 oddzielne i niepowiązane urządzenia. Urządzenie hierarchiczne Matter, takie jak lodówka, może być reprezentowane w interfejsach Home API jako zestaw urządzeń, z których każde odpowiada jednemu z punktów końcowych.

Reprezentacja wieloczęściowa

Począwszy od wersji 1.8 interfejsów Home API, urządzenie wieloczęściowe może być reprezentowane w interfejsie API jako jedno urządzenie. Aby włączyć to zachowanie, wywołaj metodę devices() w Structure, Room lub HomeManager i ustaw parametr enableMultipartDevices na true:

var multipartDevice = structure.devices(enableMultipartDevices = multipartEnabled)
var multipartDevice = multipartDevices.list().filter{ device ->  device.has(PowerStrip)}

Poniższe diagramy pokazują, jak opcja enableMultipartDevices wpływa na reprezentację urządzenia wieloczęściowego w interfejsach Home API:

Zawsze możesz uzyskać reprezentację płaską, pomijając parametr enableMultipartDevices lub ustawiając go na false.

Poruszanie się po urządzeniu składającym się z kilku części

W urządzeniu wieloczęściowym każda instancja komponentu typu urządzenia jest nazywana częścią.

Dostęp do części można uzyskać bezpośrednio na urządzeniu nadrzędnym lub w części w sposób hierarchiczny, używając typów urządzeń lub tagów semantycznych Matter. Tagi semantyczne są implementowane w interfejsach Home API za pomocą DescriptorTrait.SemanticTagStruct.

Klasa abstrakcyjna DeviceType implementuje interfejs HasParts, co pozwala deweloperom poruszać się po drzewie urządzeń za pomocą właściwości parts i metody part(). Każda instancja części implementuje też interfejs HasParts, więc wywołanie parts() na części powoduje utworzenie listy zawierającej co najmniej 0 podczęści.

Poniższy przykład pokazuje, jak uzyskać dostęp do części urządzenia z wieloma przełącznikami:

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

Kolejny przykład pokazuje, jak uzyskać dostęp do części lodówki:

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