iOS'te cihaz durumunu izleme

iOS için Home API'lerinde, evdeki durum değişikliklerini gözlemlemek için Swift'te Combine çerçevesi kullanılır. Home API'lerindeki yapılarda, odalarda, cihaz meta verilerinde ve cihaz durumunda yapılan değişiklikleri gözlemlemek için HomeDevice kullanılarak herhangi bir API'den yararlanılabilir. Bu işlem, eşzamansız etkinliklerden değerler sunan yayıncılara abone olunarak yapılır.

Bir koleksiyondaki herhangi bir öğe eklendiğinde, silindiğinde veya değiştirildiğinde koleksiyonun en son anlık görüntüsü döndürülür.

Bu anlık görüntüyü eski bir kopyayla karşılaştırarak belirli değişiklikleri belirlemek geliştiricinin sorumluluğundadır. id alanı, bu amaçla kullanılabilir. Ev API'lerindeki her üst nesne türü için sağlanır.

İsteğe bağlı nesneleri sarmalama

Bir nesne isteğe bağlı olduğunda, nesneyi güvenli bir şekilde sarmalamadan çıkarmak için if let veya guard kullanın. ! öğesini kullanmayın. !, geliştirici nesnenin kesinlikle boş olamayacağını bilmediği sürece asla kullanılmamalıdır.

Örnekteki structureID giriş parametresi String? olarak tanımlanır. Bu, parametrenin isteğe bağlı bir dize olduğu ve boş olma olasılığının bulunduğu anlamına gelir. Bu işlev, structureID hücresindeki girişe göre Structure nesnesini bulur.

İsteğe bağlı nesneleri aşağıdaki şekilde kullanmanızı öneririz:

func structure(structureID: String?) -> Structure? {
    guard let structureID else { return nil }
    return structures.first { $0.id == structureID }
  }

Yayıncıları kullanma

Aşağıda, Home API'lerinde yayıncılarla çalışmaya dair bazı temel örnekler verilmiştir. Aşağıdaki örnekler için Home örneği oluşturulmalıdır.

var home: Home?

Koleksiyonlara erişmeden önce, isteğe bağlı oldukları için bunları açtığınızdan emin olun:

guard let home else { return nil }

Bir yapıda yapılan değişiklikleri izleme

Bir yapıda aşağıdaki değişiklikler yapıldığında bu koleksiyon tetiklenir:

• Yapı adı

home.structures().batched()
  .compactMap { $0.first(where: { $0.id = myStructureID} }
  .removeDuplicates()
  .sink { structure in
    if let structure = structure {
      print("Structure \(structure.id) updated to \(structure.name)")
    }
  }

Belirli bir cihazdaki değişiklikleri izleme

Bir cihazda aşağıdaki değişiklikler yapıldığında bu koleksiyon tetiklenir:

• Bağlantı durumu
• Cihaz adı
• Room üyeliği
• Desteklenen özellikler kümesi
• Desteklenen türler kümesi

home.devices().batched()
  .compactMap { deviceList -> HomeDevice? in
    deviceList.filter { $0.name == "Bedroom Lamp"}.first
  }
  .removeDuplicates()
  .sink { lampDevice in
    if lampDevice != nil {
      print("The bedroom lamp has changed!")
    }
  }

Cihazdaki belirli bir özelliğin değişikliklerini izleme

Cihaz ve Home API'leri tarafından desteklenen tüm özellikleri kullanın. Tam liste için Trait başlıklı makaleyi inceleyin.

device.types.subscribe(OnOffLightDeviceType.self)
  .compactMap { $0.matterTraits.onOffTrait }
  .removeDuplicates()
  .sink { onOffState in
    if let onOffState = onOffState {
      print("Got new state update: \(onOffState.onOff)")
    }
  }

Cihazda belirli bir türdeki değişiklikleri izleme

Bir cihaz türünde yapılan aşağıdaki değişiklikler bu koleksiyonu tetikler:

• Oluşturulan cihaz türü içindeki herhangi bir özellikte yapılan değişiklikler

Home API'leri tarafından desteklenen herhangi bir Matter cihaz türünü kullanın. Tam liste için DeviceType sayfasına bakın.

device.types.subscribe(DimmableLightDeviceType.self)
  .compactMap { $0.matterTraits.levelControlTrait }
  .removeDuplicates()
  .sink { dimmableLightDevice in
    if let dimmableLightDevice = dimmableLightDevice
      print("Got new state update! \(levelControlTrait.currentLevel)")
    }
  }

Bir yapıdaki odada yapılan değişiklikleri izleme

Bir odada aşağıdaki değişiklikler yapıldığında bu koleksiyon tetiklenir:

• Oda adı
• Üyelik yapısı

Cihazların bir odaya ne zaman eklendiğini veya odadan ne zaman kaldırıldığını takip etmek için devices() sorgusunu kullanın.

home.rooms().batched()
  .sink { rooms in
    print("Got a new updated set of rooms!")
    for room in rooms {
      print("Got room #\(room.name)")
    }
  }

Etkinliklere abone olma

Home API'lerinde, bir cihazın durumundaki değişiklikleri algılamak için etkinlikler kullanılır.

self.cancellable = self.device.types.subscribe(FanDeviceType.self)
  .receive(on: DispatchQueue.main)
  .catch { error in
    // Error getting FanDeviceType
    return Empty<FanDeviceType, Never>().eraseToAnyPublisher()
  }
  .sink { [weak self] fanDeviceType in
    self?.fanDeviceType = fanDeviceType
    self?.updateTileInfo()
  }
}