iOS 设备上的多部分设备

某些 Matter 设备由多个具有相同设备类型的端点组成。其他 Matter 设备采用分层结构，端点嵌套在其他端点内。在 Home API 中，这两种设备都称为多部分设备。

扁平表示形式

在 Home API 的 1.8 版发布之前，Home API 将多部分设备表示为一组单独的、不相关的设备。这称为“扁平”表示法。

例如，一个带有四个开关的单墙面板设备在 Home API 中显示为四个不同的无关设备。冰箱等分层 Matter 设备在 Home API 中可能表示为一组设备，每个设备对应一个端点。

• 

  4 开关墙面板的平面表示。

  
• 

  冰箱的扁平化表示

  

多部分表示法

从 Home API 的 1.8 版开始，多部分设备可以在 API 中表示为单个设备。如需启用此行为，请在 Home 实例上调用 devices() 方法，并将 enableMultipartDevices 参数设置为 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)

以下图表说明了 enableMultipartDevices 选项如何影响 Home API 中多部分设备的表示方式：

• 

  墙板的多部分表示形式。

  
• 

  冰箱的多部分表示形式。

  

您可以随时选择通过以下方式获取扁平表示形式：省略 enableMultipartDevices 参数或将其设置为 false。

浏览多部件设备

在多部分设备中，设备类型的每个组件实例都称为“部件”。

可以使用设备类型或 Matter 语义标记，直接在父设备上或以分层方式访问部件。语义标记是在 Home API 中通过 SemanticTag 实现的。

开发者可以通过 parts() 方法遍历设备树，DeviceType 类支持此操作：

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

以下示例展示了如何访问冰箱设备的部分内容：

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