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'lerdeki yapılar, odalar, cihaz meta verileri ve cihaz durumundaki değişiklikleri gözlemlemek için HomeDevice kullanan herhangi bir API'yi kullanabilirsiniz. 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.

Geliştirici, bu anlık görüntüyü eski bir kopyayla karşılaştırarak değişiklikleri belirleyebilir. Bu amaçla, Home API'lerindeki her üst nesne türü için sağlanan id alanı kullanılabilir.

İsteğe bağlı nesneleri sarmalama

Bir nesne isteğe bağlı olduğunda, nesnenin güvenli bir şekilde sarmalanmasını açmak için if let veya guard kullanın. ! kullanmayın. Çünkü geliştirici, nesnenin kesinlikle boş olamayacağını bilmediği sürece ! hiçbir zaman kullanılmamalıdır.

Örnekteki giriş parametresi structureID, String? olarak tanımlanır. Bu, isteğe bağlı olan ve boş olma olasılığı bulunan bir dize olduğu anlamına gelir. Bu işlev, structureID içindeki 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ı
• Oda ü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)")
    }
  }

Cihazdaki belirli bir türde yapılan 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 bölümüne 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ı
• Structure üyeliği

Cihazların odaya eklenme veya odadan kaldırılma zamanını izlemek 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()
  }
}