Schema der Türklingel

Nest Doorbell (alte Version) Nest Doorbell (mit Akku) Nest Doorbell (mit Kabel) 

sdm.devices.traits.DoorbellChime

Diese Eigenschaft gehört zu jedem Gerät, das eine Glocke für die Türklingel und damit verbundene Drückenereignisse unterstützt.

Felder

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

Befehle

Für diese Eigenschaft sind keine Befehle verfügbar.

Veranstaltungen

Glocke

Aktualisierbar 

Die Türklingel wurde betätigt.

Für dieses Ereignis können Benachrichtigungen aktualisiert werden. Vorhandene App-Benachrichtigungen, die auf Grundlage dieses Ereignisses erstellt wurden, können mit dem Inhalt eines nachfolgenden Ereignisses mit demselben eventThreadId aktualisiert werden.

Glockenereignis

Nutzlast

{
  "eventId" : "854a3723-c351-45df-95e9-aed6004c1352",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "mq-qjzq6wgrOPERrPw7OMmBZPN..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Glockenereignisfelder

Field Beschreibung Datentyp
eventSessionId Nest Doorbell (mit Akku) Nest Doorbell (mit Kabel) Eine ID, die Ereignissen im Rahmen einer einzelnen Sitzung verwandter Ereignisse zugeordnet wird. Kann zur Konsolidierung von Ereignissen verwendet werden.

Damit verknüpfen Sie dieses Ereignis mit dem zugehörigen Ereignis ClipPreview des Traits „CameraClipPreview“.

 string
Beispiel: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...“
eventId Nest Doorbell (alte Version) Eine mit dem Ereignis verknüpfte ID.

Verwenden Sie es zusammen mit dem Befehl „GenerateImage“, um das Kamerabild für dieses Ereignis herunterzuladen.

 string
Beispiel: „mq-qjzq6wgrOPERrPw7OMmBZPN...“

Felder der Ereignisnutzlast

Field Beschreibung Datentyp
eventId Die eindeutige Kennung des Ereignisses. string
Beispiel: „854a3723-c351-45df-95e9-aed6004c1352“
timestamp Der Zeitpunkt, zu dem das Ereignis aufgetreten ist. string
Beispiel: „2019-01-01T00:00:01Z“
resourceUpdate Ein Objekt, das Informationen zum Ressourcenupdate enthält. object
userId Eine eindeutige, verschleierte Kennung, die den Nutzer repräsentiert. string
Beispiel: „AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi“
eventThreadId Aktualisierbar Die eindeutige Kennung des Ereignis-Threads. 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 finden Sie unter Ereignisse.

Fehler

Die folgenden Fehlercodes können in Bezug auf dieses Merkmal 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. Achten Sie darauf, das Bild vor dem Ablaufdatum herunterzuladen.
Ereignis-ID gehört nicht zur Kamera. FAILED_PRECONDITION Verwenden Sie den korrekten eventID, der vom Kamera-Ereignis zurückgegeben wurde.

Eine vollständige Liste der API-Fehlercodes finden Sie in der API-Fehlercode-Referenz.