Schéma de DoorbellCarme
Nest Doorbell (ancienne version)
sdm.devices.traits.DoorbellChime
Cette caractéristique appartient à tout appareil compatible avec le carillon et les événements de presse associés.
Champs
Aucun champ n'est disponible pour cette caractéristique.
Commandes
Aucune commande n'est disponible pour cette caractéristique.
Événements
Carillon
Mise à jourUne pression sur la sonnette a été déclenchée.
Cet événement accepte les notifications pouvant être mises à jour. Les notifications d'applications existantes créées à partir de cet événement peuvent être modifiées à l'aide du contenu d'un événement ultérieur avec le même eventThreadId
.
Événement de carillon
Charge utile
{ "eventId" : "05006845-537a-4c5c-b541-797bb72cb75a",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.DoorbellChime.Chime
" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "7xHeT28-n8_MV8o3_7xzlZejO_..." } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
"eventThreadState" : "STARTED",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }
Champs d'événement de carillon
Champ | Description | Type de données |
---|---|---|
eventSessionId |
Nest Doorbell (batterie) Utilisez-le pour associer cet événement à l'événement ClipPreview associé à la caractéristique CameraClipPreview. |
string Exemple : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..." |
eventId |
Nest Doorbell (ancienne sonnette) Utilisez-la avec la commande GenerateImage pour télécharger l'image de la caméra associée à cet événement. |
string Exemple : "7xHeT28-n8_MV8o3_7xzlZejO_..." |
Champs de charge utile de l'événement
Champ | Description | Type de données |
---|---|---|
eventId |
Identifiant unique de l'événement. | string Exemple : "05006845-537a-4c5c-b541-797bb72cb75a" |
timestamp |
L'heure à laquelle l'événement s'est produit. | string Exemple : "2019-01-01T00:00:01Z" |
resourceUpdate |
Objet qui détaille des informations sur la mise à jour de la ressource. | object |
userId |
Identifiant unique et obscurci qui représente l'utilisateur. | string Exemple : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi" |
eventThreadId |
Updateable |
string Exemple : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59" |
eventThreadState |
Updateable |
string Valeurs : "STARTED", "UPDATED", "ENDED" |
resourceGroup |
Objet qui indique les ressources susceptibles d'avoir des mises à jour semblables à 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 |
Consultez l'article Événements pour en savoir plus sur les différents types d'événements et comment ils fonctionnent.
Erreurs
Le ou les codes d'erreur suivants peuvent être renvoyés pour cette caractéristique:
Message d'erreur | RPC | Dépannage |
---|---|---|
L'image de l'appareil photo n'est plus disponible au téléchargement. | DEADLINE_EXCEEDED |
Les images d'un événement expirent 30 secondes après leur publication. Veillez à télécharger l'image avant qu'elle n'expire. |
L'ID d'événement n'appartient pas à la caméra. | FAILED_PRECONDITION |
Utilisez le bon eventID renvoyé par l'événement enregistré. |
Consultez la documentation de référence sur les codes d'erreur de l'API pour la liste complète des codes d'erreur de l'API.