DoorbellChime-Schema

Nest Doorbell (Legacy) Nest Doorbell (mit Akku) Nest Doorbell (mit Kabel)

sdm.devices.traits.DoorbellChime

Dieses Attribut gehört zu allen Geräten, die eine Türklingel und zugehörige Ereignisse beim Drücken der Klingel unterstützen.

Felder

Für dieses Attribut sind keine Felder verfügbar.

Befehle

Für dieses Attribut sind keine Befehle verfügbar.

Ereignisse

Glocke

Aktualisierbar

Die Türklingel wurde gedrückt.

Dieses Ereignis unterstützt aktualisierbare Benachrichtigungen. Bestehende App-Benachrichtigungen, die aus diesem Ereignis erstellt wurden, können mit dem Inhalt eines nachfolgenden Ereignisses mit derselben eventThreadId aktualisiert werden.

Glockenereignis

Nutzlast

{
  "eventId" : "f465913d-80b8-4163-b588-b41fdffad9d5",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "Mr84kaey9LzBODxEWo7x1pyE70..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Felder für Glockenereignisse

Feld	Beschreibung	Datentyp
`eventSessionId`	Nest Doorbell (mit Akku) Nest Doorbell (mit Kabel) Eine ID für Ereignisse, die im Rahmen einer einzelnen Sitzung zusammengehöriger Ereignisse auftreten. Kann zum Zusammenfassen von Ereignissen verwendet werden. Verwende diese Option, um dieses Ereignis mit dem zugehörigen ClipPreview-Ereignis des CameraClipPreview-Attributs zu verknüpfen.	`string` Beispiel: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...“
`eventId`	Nest Doorbell (Legacy) Eine ID, die mit dem Ereignis verknüpft ist. Verwende sie mit dem Befehl GenerateImage, um das Kamerabild herunterzuladen, das mit diesem Ereignis verknüpft ist.	`string` Beispiel: „Mr84kaey9LzBODxEWo7x1pyE70...“

Felder für Ereignisnutzlast

Feld	Beschreibung	Datentyp
`eventId`	Die eindeutige Kennung für das Ereignis.	`string` Beispiel: „f465913d-80b8-4163-b588-b41fdffad9d5“
`timestamp`	Die Zeit, in der das Ereignis aufgetreten ist.	`string` Beispiel: „2019-01-01T00:00:01Z“
`resourceUpdate`	Ein Objekt mit Details zur Ressourcenaktualisierung.	`object`
`userId`	Eine eindeutige, verschleierte Kennung, die den Nutzer darstellt.	`string` Beispiel: „AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi“
`eventThreadId`	Aktualisierbar Die eindeutige Kennung für den Ereignis-Thread.	`string` Beispiel: „d67cd3f7-86a7-425e-8bb3-462f92ec9f59“
`eventThreadState`	Aktualisierbar Der Status des Ereignis-Threads.	`string` Werte: „STARTED“, „UPDATED“, „ENDED“
`resourceGroup`	Ein Objekt, das Ressourcen angibt, die ähnliche Aktualisierungen wie dieses Ereignis haben könnten. Die Ressource des Ereignisses selbst (aus dem `resourceUpdate` Objekt) ist immer in diesem Objekt vorhanden.	`object`

Weitere Informationen zu den verschiedenen Ereignistypen und ihrer Funktionsweise findest du unter Ereignisse.

Fehler

Die folgenden Fehlercodes können im Zusammenhang mit diesem Attribut zurückgegeben werden:

Fehlermeldung	RPC	Fehlerbehebung
Das Kamerabild kann nicht mehr heruntergeladen werden.	`DEADLINE_EXCEEDED`	Ereignisbilder laufen 30 Sekunden nach der Veröffentlichung des Ereignisses ab. Lade das Bild vor Ablauf der Frist herunter.
Die Ereignis-ID gehört nicht zur Kamera.	`FAILED_PRECONDITION`	Verwende die korrekte `eventID`, die vom Kameraereignis zurückgegeben wurde.

Eine vollständige Liste der API-Fehlercodes findest du in der API-Fehlercode-Referenz.