如何通过matterNodeId访问HMAccessory并读取Matter集群？

核心结论 #

HomeKit原生API不直接暴露Matter配件的底层集群信息，它将Matter集群封装为上层的HMService（服务）和HMCharacteristic（特征）。如果需要直接操作Matter原始集群，必须结合Apple的Matter SDK实现。

关键逻辑说明 #

HomeKit对Matter设备做了一层抽象映射：

• 比如Matter的On/Off集群对应HomeKit的Switch服务
• Temperature Measurement集群对应Temperature Sensor服务
  你可以通过HMAccessory.services查看这些抽象后的服务，但无法直接获取原始Matter集群数据。

用Matter SDK访问集群的示例代码 #

要直接读取Matter集群，需通过Matter SDK关联已配网的HomeKit设备，步骤如下：

import Matter
import HomeKit

// 传入已获取权限的HMAccessory和HMHome实例
func fetchMatterClusterData(for accessory: HMAccessory, in home: HMHome) async throws {
    guard let nodeID = accessory.matterNodeID else { return }
    
    // 获取全局Matter设备控制器
    guard let matterController = MTRDeviceController.sharedInstance() else {
        throw NSError(domain: "MatterError", code: -1, userInfo: [NSLocalizedDescriptionKey: "无法获取Matter控制器实例"])
    }
    
    // 将HomeKit家庭ID与Matter节点关联
    try await matterController.assignHome(home.homeID, toNodeWithID: nodeID)
    
    // 获取Matter设备实例
    guard let matterDevice = matterController.device(forNodeID: nodeID) else {
        throw NSError(domain: "MatterError", code: -2, userInfo: [NSLocalizedDescriptionKey: "无法获取Matter设备实例"])
    }
    
    // 示例1：读取On/Off集群的开关状态
    let onOffCluster = MTROnOffCluster(device: matterDevice, endpointID: 0)
    let isOn = try await onOffCluster.readAttributeOn()
    print("On/Off集群状态：\(isOn)")
    
    // 示例2：读取Temperature Measurement集群的温度值
    let tempCluster = MTRTemperatureMeasurementCluster(device: matterDevice, endpointID: 0)
    let tempValue = try await tempCluster.readAttributeMeasuredValue()
    print("温度测量值：\(tempValue) °C")
}

注意事项 #

• 确保App已添加HomeKit和Matter能力（Xcode的Signing & Capabilities面板中配置）
• 需获取用户授权访问HomeKit家庭数据
• 不同Matter集群对应SDK中不同的MTR*Cluster类（如MTRLevelControlCluster对应Level Control集群）
• 转换失败通常是因为未正确关联HomeKit家庭ID与Matter节点，或未获取有效控制器实例

内容的提问来源于stack exchange，提问作者murali_vm