Schéma DoorbellChime

Nest Doorbell (ancienne version) Nest Doorbell (batterie) Nest Doorbell (filaire) 

sdm.devices.traits.DoorbellChime

Ce trait appartient à tout appareil compatible avec un carillon de sonnette et les événements d'appui associés.

Champs

Aucun champ n'est disponible pour ce trait.

Commandes

Aucune commande n'est disponible pour ce trait.

Événements

Carillon

Modifiable 

Quelqu'un a appuyé sur la sonnette.

Cet événement est compatible avec les notifications modifiables. Les notifications d'application existantes créées à partir de cet événement peuvent être mises à jour à l'aide du contenu d'un événement ultérieur avec le même eventThreadId.

Événement "Carillon"

Charge utile

{
  "eventId" : "9837d27a-bca9-44bb-89a6-1ff0e4328373",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "N_7BRBopcb2ql0aHlI6oz370K6..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Champs de l'événement Chime

Champ Description Type de données
eventSessionId Nest Doorbell (batterie) Nest Doorbell (filaire) ID attribué aux événements qui se produisent dans le cadre d'une même session d'événements associés. Peut être utilisé pour consolider les événements.

Utilisez-le pour associer cet événement à l'événement ClipPreview associé de la caractéristique CameraClipPreview.

 string
Exemple : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId Nest Doorbell (ancienne version) ID associé à l'événement.

Utilisez-le avec la commande GenerateImage pour télécharger l'image de la caméra associée à cet événement.

 string
Exemple : "N_7BRBopcb2ql0aHlI6oz370K6..."

Champs de la charge utile de l'événement

Champ Description Type de données
eventId Identifiant unique de l'événement. string
Exemple : "9837d27a-bca9-44bb-89a6-1ff0e4328373"
timestamp Heure à laquelle l'événement s'est produit. string
Exemple : "2019-01-01T00:00:01Z"
resourceUpdate Objet contenant des informations détaillées sur la modification de la ressource. object
userId Identifiant unique et obscurci représentant l'utilisateur. string
Exemple : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
eventThreadId Modifiable Identifiant unique du fil d'événements. string
Exemple : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState Updateable État du thread d'événements. string
Valeurs : "STARTED", "UPDATED", "ENDED"
resourceGroup Objet qui indique les ressources susceptibles d'avoir des modifications similaires de cet événement. La ressource de l'événement lui-même (à partir de l'objet resourceUpdate) sera toujours présente dans cet objet. object

Pour en savoir plus sur les différents types d'événements et leur fonctionnement, consultez Événements.

Erreurs

Les codes d'erreur suivants peuvent être renvoyés pour ce trait :

Message d'erreur RPC Dépannage
L'image de la caméra n'est plus disponible au téléchargement. DEADLINE_EXCEEDED Les images d'événements expirent 30 secondes après la publication de l'événement. Veillez à télécharger l'image avant l'expiration.
L'ID d'événement n'appartient pas à la caméra. FAILED_PRECONDITION Utilisez la valeur eventID correcte renvoyée par l'événement de caméra.

Consultez la documentation de référence sur les codes d'erreur de l'API pour obtenir la liste complète des codes d'erreur de l'API.