Diese Seite wurde von der Cloud Translation API übersetzt.

Gerätestatus auf Android-Geräten überwachen

In den Home APIs für Android können Änderungen des Status im Zuhause mithilfe von Abläufen in Kotlin beobachtet werden. Änderungen an Gebäuden, Räumen, Gerätemetadaten und Gerätestatus in den Home APIs können mit jeder API beobachtet werden, die von der HomeObjectsFlow-Schnittstelle abgeleitet ist. Dazu werden die Daten aus dem Fluss erfasst.

Wenn ein Element in einer Sammlung hinzugefügt, gelöscht oder geändert wird, wird der aktuelle Snapshot der Sammlung zurückgegeben.

Es liegt in der Verantwortung des Entwicklers, die Änderungen zu ermitteln, indem er diesen Snapshot mit einer älteren Kopie vergleicht. Das Feld id, das für jeden übergeordneten Objekttyp in den Home APIs bereitgestellt wird, kann zu diesem Zweck verwendet werden.

Aufrufabfolgen verwenden

Im Folgenden finden Sie einige grundlegende Beispiele für die Erhebung von Daten aus Abläufen in den Home APIs. Für die folgenden Beispiele muss eine Instanz von Home erstellt werden, bevor auf Sammlungen im Zuhause zugegriffen werden kann:

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

Änderungen an einer Struktur verfolgen

Die folgenden Änderungen an einem Gebäude lösen diese Sammlung aus:

Name des Gebäudes

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

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

Änderungen an einem bestimmten Gerät verfolgen

Die folgenden Änderungen an einem Gerät lösen diese Sammlung aus:

Verbindungsstatus
Gerätename
Teilnahme am Gruppenbereich
Die unterstützten Traits
Die unterstützten Typen

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

Änderungen an einem bestimmten Merkmal auf einem Gerät verfolgen

Verwenden Sie ein beliebiges Attribut, das vom Gerät und den Home APIs unterstützt wird. Eine vollständige Liste finden Sie unter Trait.

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

Änderungen an einem bestimmten Typ auf einem Gerät verfolgen

Die folgenden Änderungen an einem Gerätetyp lösen diese Sammlung aus:

Änderungen an einem Merkmal innerhalb des generierten Gerätetyps

Verwenden Sie einen beliebigen Matter-Gerätetyp, der von den Home APIs unterstützt wird. Eine vollständige Liste finden Sie unter DeviceType.

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

Änderungen an einem Raum in einem Gebäude verfolgen

Die folgenden Änderungen an einem Chatroom lösen diese Sammlung aus:

Wenn Sie nachverfolgen möchten, wann Geräte einem Raum hinzugefügt oder daraus entfernt werden, verwenden Sie den devices()-Vorgang.

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

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

Ereignisse abonnieren

In den Home APIs werden Ereignisse verwendet, um Änderungen am Status eines Geräts zu erkennen.

Wenn Sie Ereignisse auf einem bestimmten Gerät abonnieren möchten, rufen Sie eine der drei HomeDevice auf.events-Funktionen, die jeweils einenFlow<Event> zurückgeben:

events(event: EventFactory<T>) gibt einen Ablauf für eine bestimmte Art von Ereignis zurück:

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

events(trait: TraitFactory<T>) gibt einen Stream aller Ereignisse zurück, die von einem Merkmal gesendet wurden:
```
val eventflow = homeDevice.type(DoorLockDevice).first().events(DoorLock)
```
events() gibt einen Ablauf von Ereignissen zurück, die für das Objekt verfügbar sind:
```
val eventflow = homeDevice.type(DoorLockDevice).first().events()
```

Verwenden Sie die Funktion flow.collect(), um Ereignisse aus einem Fluss zu verarbeiten:

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

Ereignisse für Entitätsbeziehungen abonnieren

Sie können nach Ereignissen suchen, die jedes Mal ausgegeben werden, wenn ein Element (z. B. ein Gebäude, ein Raum, ein Gerät oder eine Automatisierung) hinzugefügt, entfernt oder aktualisiert wird. Diese Ereignisse sind Instanzen von HomeObjectChangeEvent und enthalten die ID der geänderten Entität.

Wenn Sie einen Stream abrufen möchten, der die gewünschten Ereignisse generiert, rufen Sie die Methode stream() auf HomeObjectsFlow<T>, die von der entsprechenden Ablaufmethode generiert wird:

*Tabelle: Ereignisstreams*
Entität	Schnittstelle	Ablaufmethode
`Structure`	`HasStructures`	`structures()`
`Room`	`HasRooms`	`rooms()`
`HomeDevice`	`HasHomeDevices`	`devices()`
`Automation`	`HasAutomations`	`automations()`

So gehen Sie beispielsweise bei Änderungen an Geräten vor:

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 -> {}
  }
}