Интеграция HomeKit для управления умным домом через iOS

Интеграция HomeKit для управления умным домом через iOS

HomeKit — это Apple-экосистема для умного дома: лампы, термостаты, замки, датчики. Приложение получает доступ к аксессуарам через HomeKit.framework, управляет ими через HMAccessory и HMCharacteristic. Но прежде чем писать первую строку кода, нужно понять: HomeKit работает только с сертифицированным оборудованием, а процедура тестирования с реальными аксессуарами в Apple HomeKit simulator имеет свои ограничения.

Основные концепции HomeKit

HMHome — дом. Может быть несколько (основной, дача). HMRoom — комната внутри дома. HMAccessory — физическое устройство (лампа, замок). HMService — функция аксессуара (лампа имеет сервис освещения + информационный сервис). HMCharacteristic — конкретный атрибут сервиса: яркость, цветовая температура, состояние замка.

Иерархия: Home → Room → Accessory → Service → Characteristic.

Настройка и получение доступа

import HomeKit

class HomeKitManager: NSObject, HMHomeManagerDelegate {
    let homeManager = HMHomeManager()

    override init() {
        super.init()
        homeManager.delegate = self
    }

    func homeManagerDidUpdateHomes(_ manager: HMHomeManager) {
        guard let home = manager.primaryHome else {
            // нет настроенного дома — предлагаем создать или добавить аксессуары
            return
        }
        listAccessories(in: home)
    }

    func listAccessories(in home: HMHome) {
        for accessory in home.accessories {
            print("Accessory: \(accessory.name)")
            for service in accessory.services {
                print("  Service: \(service.serviceType)")
                for characteristic in service.characteristics {
                    print("    Characteristic: \(characteristic.characteristicType)")
                }
            }
        }
    }
}

Info.plist обязателен: NSHomeKitUsageDescription. Без него — краш при первом обращении к HMHomeManager.

Entitlement: com.apple.developer.homekit — запрашивается через Apple Developer Portal. Без него приложение не может взаимодействовать с HomeKit даже на симуляторе с виртуальными аксессуарами.

Чтение и запись характеристик

func setLightBrightness(_ accessory: HMAccessory, brightness: Int) {
    guard let lightService = accessory.services.first(where: {
        $0.serviceType == HMServiceTypeLightbulb
    }),
    let brightnessChar = lightService.characteristics.first(where: {
        $0.characteristicType == HMCharacteristicTypeBrightness
    }) else { return }

    brightnessChar.writeValue(brightness) { error in
        if let error = error {
            // HMError.communicationFailure — аксессуар недоступен
            // HMError.operationNotSupported — характеристика read-only
            print("Write failed: \(error)")
        }
    }
}

func readCurrentTemperature(_ accessory: HMAccessory) {
    guard let thermostat = accessory.services.first(where: {
        $0.serviceType == HMServiceTypeThermostat
    }),
    let tempChar = thermostat.characteristics.first(where: {
        $0.characteristicType == HMCharacteristicTypeCurrentTemperature
    }) else { return }

    tempChar.readValue { error in
        if error == nil {
            let temp = tempChar.value as? Double
            print("Temperature: \(temp ?? 0)°C")
        }
    }
}

Подписка на события

func subscribeToLockState(_ lockChar: HMCharacteristic) {
    lockChar.enableNotification(true) { error in
        guard error == nil else { return }
        // теперь делегат HMAccessoryDelegate получает уведомления
    }
}

// HMAccessoryDelegate:
func accessory(_ accessory: HMAccessory,
               service: HMService,
               didUpdateValueFor characteristic: HMCharacteristic) {
    if characteristic.characteristicType == HMCharacteristicTypeCurrentLockMechanismState {
        let isLocked = characteristic.value as? Int == 1
        updateLockUI(isLocked: isLocked)
    }
}

Автоматизации и триггеры

HMTrigger — автоматизация по условию. Два типа:

• HMTimerTrigger — по времени
• HMEventTrigger — по событию (открытие двери, изменение температуры)

let fireDate = Date().addingTimeInterval(3600)
let timer = HMTimerTrigger(name: "Evening lights", fireDate: fireDate,
                            timeZone: .current, recurrence: nil, recurrenceCalendar: nil)
home.addTrigger(timer) { error in
    guard error == nil else { return }
    // добавляем action set к триггеру
}

Симулятор аксессуаров для разработки

Apple HomeKit Accessory Simulator (часть Xcode Additional Tools) создаёт виртуальные аксессуары на Mac. Приложение в симуляторе iOS видит их через Wi-Fi. Это единственный способ разрабатывать без реального оборудования.

Ограничение: некоторые сценарии (Bluetooth аксессуары, Thread-устройства) с симулятором не работают полностью — нужен реальный iPhone и сертифицированный аксессуар.

Matter vs HomeKit

Matter (новый стандарт умного дома) работает через HomeKit как один из транспортов на iOS. HMAccessory с Matter профилем появляется в HomeKit автоматически при добавлении через HMHome.addAndSetupAccessories. Отдельной обработки не требуется — HomeKit абстрагирует протокол.

Срок интеграции: 1-2 недели — управление аксессуарами, чтение/запись характеристик, базовые автоматизации. Стоимость рассчитывается индивидуально.