ตรวจสอบสถานะอุปกรณ์ใน iOS

ใน Home API สำหรับ iOS การสังเกตการเปลี่ยนแปลงสถานะในบ้านทำได้โดยใช้เฟรมเวิร์ก Combine ใน Swift การสังเกตการเปลี่ยนแปลงในบ้าน ห้อง ข้อมูลเมตาของอุปกรณ์ และสถานะอุปกรณ์ใน Home API สามารถทำได้ด้วย API ใดก็ได้โดยใช้ HomeDevice ซึ่งทำได้โดยสมัครรับข้อมูลจากผู้เผยแพร่โฆษณาที่แสดงค่าจากเหตุการณ์แบบอะซิงโครนัส

เมื่อมีการเพิ่ม ลบ หรือแก้ไขรายการใดๆ ในคอลเล็กชัน ระบบจะแสดงภาพรวมล่าสุดของคอลเล็กชัน

นักพัฒนาแอปต้องสรุปการเปลี่ยนแปลงที่เฉพาะเจาะจงโดยเปรียบเทียบสแนปชอตนี้กับสำเนาที่เก่ากว่า คุณสามารถใช้ช่อง id ที่มีให้สำหรับออบเจ็กต์หลักแต่ละประเภทใน Home API เพื่อวัตถุประสงค์นี้ได้

วิธีแกะออบเจ็กต์ที่ไม่บังคับ

เมื่อออบเจ็กต์เป็นแบบไม่บังคับ ให้ใช้ if let หรือ guard เพื่อแกะออบเจ็กต์อย่างปลอดภัย อย่าใช้ ! เนื่องจากไม่ควรใช้ ! เว้นแต่นักพัฒนาแอปจะทราบแน่ชัดว่าออบเจ็กต์เป็นค่าว่างไม่ได้

พารามิเตอร์อินพุต structureID ในตัวอย่างกำหนดเป็น String? ซึ่งหมายความว่าเป็นสตริงที่ไม่บังคับและอาจเป็นค่าว่างได้ ฟังก์ชันนี้จะค้นหาออบเจ็กต์ Structure โดยอิงตามข้อมูลที่ป้อนใน structureID

เราขอแนะนำให้คุณจัดการออบเจ็กต์ที่ไม่บังคับดังนี้

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

วิธีใช้ผู้เผยแพร่โฆษณา

ต่อไปนี้เป็นตัวอย่างพื้นฐานของการทำงานกับผู้เผยแพร่โฆษณาใน Home API สำหรับตัวอย่างต่อไปนี้ คุณต้องสร้างอินสแตนซ์ของ Home

var home: Home?

ก่อนเข้าถึงคอลเล็กชัน โปรดตรวจสอบว่าได้แยกคอลเล็กชันแล้ว เนื่องจากเป็นคอลเล็กชันที่ไม่บังคับ

guard let home else { return nil }

ติดตามการเปลี่ยนแปลงในบ้าน

การเปลี่ยนแปลงต่อไปนี้ในบ้านจะทริกเกอร์คอลเล็กชันนี้

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)")
    }
  }

ติดตามการเปลี่ยนแปลงในอุปกรณ์ที่เฉพาะเจาะจง

การเปลี่ยนแปลงต่อไปนี้ในอุปกรณ์จะทริกเกอร์คอลเล็กชันนี้

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!")
    }
  }

ติดตามการเปลี่ยนแปลงลักษณะเฉพาะในอุปกรณ์

ใช้ลักษณะใดก็ได้ที่อุปกรณ์และ Home API รองรับ ดูรายการทั้งหมดได้ที่ Trait

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

ติดตามการเปลี่ยนแปลงประเภทที่เจาะจงในอุปกรณ์

การเปลี่ยนแปลงประเภทอุปกรณ์ต่อไปนี้จะทริกเกอร์คอลเล็กชันนี้

ใช้อุปกรณ์ Matter ประเภทใดก็ได้ที่ Home API รองรับ ดูรายการทั้งหมดได้ที่ DeviceType

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

ติดตามการเปลี่ยนแปลงของห้องในบ้าน

การเปลี่ยนแปลงต่อไปนี้ในห้องแชทจะทริกเกอร์คอลเล็กชันนี้

หากต้องการติดตามเมื่อมีการเพิ่มหรือนำอุปกรณ์ออกจากห้อง ให้ใช้การค้นหา devices()

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

สมัครรับข้อมูลเหตุการณ์

ใน Home API ระบบจะใช้เหตุการณ์เพื่อตรวจหาการเปลี่ยนแปลงสถานะของอุปกรณ์

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()
  }
}