SuperAPI AI 工具集

homekit

通用与其它

查看项目

更新于 10-16 05:52

技能介绍

用途:在 iOS 应用中控制智能家居配件,并通过 MatterSupport 将 Matter 硬件接入第三方生态。HomeKit 负责家庭/房间/配件层级、特征与自动化触发器;MatterSupport 负责生态内的设备调试。

设置与框架边界:在 Xcode 启用 HomeKit 能力,在 Info.plist 添加 NSHomeKitUsageDescription。使用 MatterSupport 调试时,需添加 MatterSupport Extension 目标,声明 Bonjour 服务 _matter._tcp、_matterc._udp、_matterd._udp,并将扩展的 principal class 设为 MatterAddDeviceExtensionRequestHandler。分工上,HomeKit 管家庭、房间、配件控制、特征、场景与触发器;MatterSupport 管 Matter 硬件接入;AccessorySetupKit 用于选择/配对附近蓝牙或 Wi-Fi 设备;CoreBluetooth/NetworkExtension 负责授权后的原始数据传输。

数据模型:HomeKit 异步加载,需维护单个 HMHomeManager 实例,等待 homeManagerDidUpdateHomes(_:) 回调后再访问 homes 或 primaryHome。层级为 HMHomeManager → HMHome → HMRoom → HMAccessory → HMService → HMCharacteristic。

配件与特征:通过 HMCharacteristic 读写,例如用 writeValue(_:) 设置开关,用 readValue() 读取温度,且须校验 characteristicType。

动作集与触发器:可用 addActionSet(withName:) 创建场景并添加动作;用 addTrigger(_:) 添加触发器后需 trigger.enable(true) 显式启用。

Matter 调试:构造 MatterAddDeviceRequest.Topology,用 MatterAddDeviceRequest 执行 perform(),系统会调用扩展中的 MatterAddDeviceExtensionRequestHandler 完成配对。

常见错误与限制:启动时同步读取 homes 会为空;缺少 Bonjour 服务声明会导致 Matter 调试静默失败;不要直接本地修改特征值,应调用异步 writeValue(_:);避免创建多个 HMHomeManager 实例;勿混淆 HomeKit 与 AccessorySetupKit。资料未提供收费、价格与平台细节。