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

ใน Home API สําหรับ Android คุณสามารถสังเกตการเปลี่ยนแปลงสถานะในบ้านได้โดยใช้โฟลว์ใน Kotlin คุณสามารถสังเกตการเปลี่ยนแปลงโครงสร้าง ห้อง ข้อมูลเมตาของอุปกรณ์ และสถานะของอุปกรณ์ใน Home API โดยใช้ API ใดก็ได้ที่รับค่ามาจากHomeObjectsFlow อินเทอร์เฟซ ซึ่งทำได้โดยรวบรวมจากขั้นตอน

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

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

วิธีใช้โฟลว์

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

val context = LocalContext.current
val homeManager = Home.getClient(context)

ติดตามการเปลี่ยนแปลงโครงสร้าง

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

• ชื่อโครงสร้าง

homeManager.structures().map { it.firstOrNull() }.collect {
  println("Structure ${it.id} updated to ${it}")
}

val structure =  homeManager.structures().list().firstOrNull()!!

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

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

• สถานะการเชื่อมต่อ
• ชื่ออุปกรณ์
• การเป็นสมาชิกห้อง
• ชุดลักษณะที่รองรับ
• ชุดประเภทที่รองรับ

structure
  .devices()
  .map { devices -> device.filter { it.name == "Bedroom Lamp" }.single() }
  .collect {
    println("The bedroom lamp has changed!")
  }

val device = structure.devices().list().firstOrNull { it.name == "Bedroom Lamp" }!!

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

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

device.trait(OnOff).collect {
  if (it != null) {
    println("Got new state update! ${it.onOff}")
  }
}

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

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

• การเปลี่ยนแปลงลักษณะภายในประเภทอุปกรณ์ที่สร้างขึ้น

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

device.type(DimmableLightDevice).collect { type ->
    println("Got new state update! ${type.trait(LevelControl)?.currentLevel}")
}

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

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

• ชื่อห้อง
• จัดโครงสร้างการเป็นสมาชิก

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

structure.rooms().collect {
  println("Got a new updated set of rooms!")

  for (room in it) {
    println("Got room $room")
  }
}

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

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

หากต้องการสมัครรับเหตุการณ์ในอุปกรณ์ที่ต้องการ ให้เรียกใช้ฟีเจอร์อย่างใดอย่างหนึ่งต่อไปนี้ HomeDeviceevents ฟังก์ชันแต่ละรายการจะแสดงผลFlow<Event>ดังนี้

1. events(event: EventFactory<T>) แสดงผลลําดับเหตุการณ์สําหรับเหตุการณ์ประเภทที่เฉพาะเจาะจง ดังนี้

   val eventFlow = homeDevice.type(DoorLockDevice).first().events(DoorLock.DoorLockAlarmEvent)
   

2. events(trait: TraitFactory<T>) จะแสดงผลลําดับเหตุการณ์ทั้งหมดที่ส่งโดยลักษณะ

   val eventflow = homeDevice.type(DoorLockDevice).first().events(DoorLock)
   

3. events() แสดงผลลําดับเหตุการณ์ที่ใช้ได้สําหรับออบเจ็กต์

   val eventflow = homeDevice.type(DoorLockDevice).first().events()
   

หากต้องการใช้เหตุการณ์จากโฟลว์ ให้ใช้ฟังก์ชัน flow.collect() ดังนี้

eventflow.collect { event ->
  if (event != null) {
    logger.atInfo().log("Received event %s", event)
    // do something
  }
}

ติดตามเหตุการณ์ความสัมพันธ์ของเอนทิตี

คุณสามารถฟังเหตุการณ์ที่ส่งออกทุกครั้งที่มีการเพิ่ม นําออก หรืออัปเดตเอนทิตี (เช่น โครงสร้าง ห้อง อุปกรณ์ หรือระบบอัตโนมัติ) เหตุการณ์เหล่านี้เป็นอินสแตนซ์ของ HomeObjectChangeEvent และจะมีรหัสของเอนทิตีที่มีการเปลี่ยนแปลง

หากต้องการรับสตรีมที่ทำให้เกิดเหตุการณ์ที่ต้องการ ให้เรียกใช้เมธอด stream() ใน HomeObjectsFlow<T> ที่สร้างขึ้นโดยเมธอด Flow ที่เกี่ยวข้อง ดังนี้

ตัวอย่างเช่น วิธีจัดการการเปลี่ยนแปลงอุปกรณ์มีดังนี้

val devicesStream = home.devices().stream()

// Collect and react to device changes.
devicesStream.collect { deviceEvent ->
  when (deviceEvent) {
    is HomeObjectAddedEvent ->
      println("New device now available with id: ${deviceEvent.id}")
    is HomeObjectUpdatedEvent -> println("Device ${deviceEvent.id} has been updated")
    is HomeObjectRemovedEvent -> println("Device is removed from your account")
    else -> {}
  }
}