DoorbellChime-Schema

Nest Doorbell (alt) Nest Doorbell (mit Akku) Nest Doorbell (mit Kabel) 

sdm.devices.traits.DoorbellChime

Diese Eigenschaft gehört zu jedem Gerät, das eine Türklingel und zugehörige Drück-Ereignisse unterstützt.

Felder

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

Befehle

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

Ereignisse

Glocke

Aktualizierbar 

Die Türklingel wurde betätigt.

Dieses Ereignis unterstützt aktualisierbare Benachrichtigungen. Vorhandene App-Benachrichtigungen, die auf Grundlage dieses Ereignisses erstellt wurden, können mit dem Inhalt eines nachfolgenden Ereignisses mit derselben eventThreadId aktualisiert werden.

Glockenton erkannt

Nutzlast

{
  "eventId" : "cbcfe550-7747-4258-98a9-8703306ed57e",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "oQy2FDX-yKBujCbebQbDpyb8pn..."
      }
    }
  }
  "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, die Ereignissen zugewiesen wird, die im Rahmen einer einzelnen Sitzung ähnlicher Ereignisse auftreten. Kann zum Zusammenführen von Ereignissen verwendet werden.

Verwenden Sie es, um dieses Ereignis mit dem zugehörigen Ereignis ClipPreview der Eigenschaft „CameraClipPreview“ zu verknüpfen.

 string
Beispiel: „CjY5Y3VKaTZwR3o4Y19YbTVfMF…“
eventId Nest Doorbell (alt) Eine ID, die mit dem Ereignis verknüpft ist.

Verwenden Sie ihn mit dem Befehl „GenerateImage“, um das mit diesem Ereignis verknüpfte Kamerabild herunterzuladen.

 string
Beispiel: „oQy2FDX-yKBujCbebQbDpyb8pn…“

Felder für die Ereignisnutzlast

Feld Beschreibung Datentyp
eventId Die eindeutige Kennung für das Ereignis. string
Beispiel: „cbcfe550-7747-4258-98a9-8703306ed57e“
timestamp Die Zeit, zu der das Ereignis aufgetreten ist. string
Beispiel: „2019-01-01T00:00:01Z“
resourceUpdate Ein Objekt mit Informationen zur Ressourcenaktualisierung. object
userId Eine eindeutige, verschleierte Kennung, die den Nutzer darstellt. string
Beispiel: „AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi“
eventThreadId Updateable Die eindeutige Kennung für den Ereignis-Thread. string
Beispiel: „d67cd3f7-86a7-425e-8bb3-462f92ec9f59“
eventThreadState Updateable 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 in diesem Objekt immer vorhanden. object

Weitere Informationen zu den verschiedenen Ereignistypen und ihrer Funktionsweise finden Sie unter Ereignisse.

Fehler

In Bezug auf dieses Attribut können die folgenden Fehlercodes 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. Laden Sie das Bild vor Ablauf herunter.
Die Ereignis-ID gehört nicht zur Kamera. FAILED_PRECONDITION Verwenden Sie die richtige eventID, die vom Kameraereignis zurückgegeben wird.

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