Perangkat multi-bagian di Android

Beberapa perangkat Matter terdiri dari beberapa endpoint dengan jenis perangkat yang sama. Perangkat Matter lainnya bersifat hierarkis, dengan endpoint yang berada di dalam endpoint lainnya. Di Home API, kedua jenis perangkat ini disebut sebagai perangkat multipart.

Representasi datar

Sebelum rilis 1.8 Home API, perangkat multipart direpresentasikan oleh Home API sebagai serangkaian perangkat terpisah yang tidak terkait. Hal ini disebut sebagai representasi datar.

Misalnya, satu perangkat panel dinding dengan empat sakelar muncul di Home API sebagai empat perangkat yang berbeda dan tidak terkait. Perangkat hierarkis Matter seperti kulkas dapat direpresentasikan di Home API sebagai sekumpulan perangkat, yang masing-masing sesuai dengan salah satu endpoint.

Representasi multibagian

Mulai dari rilis 1.8 Home API, perangkat multipart dapat direpresentasikan di API sebagai perangkat tunggal. Untuk mengaktifkan perilaku ini, panggil metode devices() di Structure, Room, atau HomeManager dan tetapkan parameter enableMultipartDevices ke 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)

Diagram berikut menggambarkan pengaruh opsi enableMultipartDevices terhadap representasi perangkat multi-bagian di Home API:

Anda selalu memiliki opsi untuk mendapatkan representasi datar dengan menghilangkan parameter enableMultipartDevices, atau dengan menyetelnya ke false.

Menavigasi perangkat multipart

Dalam perangkat multibagian, setiap instance komponen jenis perangkat disebut bagian.

Bagian dapat diakses langsung di perangkat induk atau bagian secara hierarkis, menggunakan jenis perangkat atau tag semantik Matter. Tag semantik diterapkan di Home API dengan DescriptorTrait.SemanticTagStruct.

Class abstrak DeviceType menerapkan antarmuka HasParts, sehingga developer dapat menjelajahi hierarki perangkat melalui properti parts dan metode part(). Setiap instance bagian juga menerapkan antarmuka HasParts, sehingga memanggil parts() pada bagian akan menghasilkan daftar nol atau lebih sub-bagian.

Contoh berikut menunjukkan cara mengakses bagian-bagian perangkat multi-sakelar:

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

Contoh berikutnya menunjukkan cara mengakses bagian-bagian perangkat kulkas:

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