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