Appareils multifaisceaux sur iOS

Certains appareils Matter sont constitués de plusieurs points de terminaison avec le même type d'appareil. D'autres appareils Matter sont hiérarchiques, avec des points de terminaison imbriqués dans d'autres points de terminaison. Dans les API Home, les deux types d'appareils sont appelés appareils multipièces.

Représentation aplatie

Avant la version 1.8 des API Home, les appareils multipièces sont représentés par les API Home comme un ensemble d'appareils distincts et sans rapport. C'est ce qu'on appelle la représentation aplatie.

Par exemple, un seul panneau mural avec quatre interrupteurs apparaît dans les API Home comme quatre appareils distincts et sans rapport. Un appareil Matter hiérarchique Matter tel qu'un réfrigérateur peut être représenté dans les API Home comme un ensemble d'appareils, chacun correspondant à l'un des points de terminaison.

  • Exemple de panneau mural avec plusieurs interrupteurs montrant la représentation Matter native et le rendu plat de l'API Home

    Représentation aplatie d'un panneau mural à quatre interrupteurs.

  • Exemple de réfrigérateur montrant la représentation Matter native et le rendu plat de l'API Home

    Représentation aplatie d'un réfrigérateur
Figure 1: Exemples de rendu aplati

Représentation multipièces

À partir de la version 1.8 des API Home, un appareil multipièces peut être représenté dans l'API comme un seul appareil. Pour activer ce comportement, appelez la devices() méthode sur l'Home instance et définissez le enableMultipartDevices paramètre sur true :

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

Les schémas suivants illustrent l'impact de l'option enableMultipartDevices sur la représentation d'un appareil multipièces dans les API Home :

  • Exemple de panneau mural avec plusieurs interrupteurs montrant la représentation Matter native et le rendu multipartie de l'API Home

    Représentation multipièces d'un panneau mural.

  • Exemple de réfrigérateur montrant la représentation Matter native et le rendu multipartie de l'API Home

    Représentation multipièces d'un réfrigérateur.
Figure 2 : Exemples de rendu multipièces

Vous pouvez toujours obtenir la représentation aplatie en omettant le paramètre enableMultipartDevices ou en le définissant sur false.

Dans un appareil multipièces, chaque instance de composant d'un type d'appareil est appelée pièce.

Vous pouvez accéder directement aux pièces sur l'appareil parent ou sur une pièce de manière hiérarchique, à l'aide de types d'appareils ou de Matter balises sémantiques. Les balises sémantiques sont implémentées dans les API Home avec SemanticTag.

La DeviceType classe permet aux développeurs de parcourir l'arborescence des appareils à l'aide de la parts() méthode :

let outlet1 = await device.parts.getAll(of: OnOffPluginUnitDeviceType.self).first {
  $0.tags.contains(SemanticTag.CommonNumber.one)
}
let outlet3 = await device.parts.getAll(of: OnOffPluginUnitDeviceType.self).first {
  $0.tags.contains(SemanticTag.CommonNumber.three)
}

L'exemple suivant montre comment accéder aux pièces d'un réfrigérateur :

let refrigerator: RefrigeratorDeviceType? =
   await home.devices(enableMultipartDevices: true).first { $0.id == FRIDGE_ID }
// Get different cabinets of the refrigerator
let freezer = refrigerator!.parts(type: TemperatureControlledCabinetDeviceType.self).first {
  $0.tags.contains(SemanticTag.Refrigerator.freezer)
}