Schéma du carillon Doorbell
Nest Doorbell (ancienne)
sdm.devices.traits.DoorbellChime
Cette caractéristique appartient à n'importe quel appareil compatible avec le carillon et les événements d'appui 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
ModifiableUne personne a appuyé sur la sonnette.
Les notifications pouvant être mises à jour sont disponibles pour cet événement. Les notifications d'applications 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 de carillon
Charge utile
{ "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" ] }
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é de la caractéristique CameraClipPreview. |
string Exemple: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..." |
eventId |
Nest Doorbell (ancienne) Utilisez-la avec la commande "GenerateImage" pour télécharger l'image de caméra associée à cet événement. |
string Exemple: "mq-qjzq6wgrOPERrPw7OMmBZPN..." |
Champs de charge utile de l'événement
Champ | Description | Type de données |
---|---|---|
eventId |
Identifiant unique de l'événement. | string Exemple: "854a3723-c351-45df-95e9-aed6004c1352" |
timestamp |
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 |
Modifiable |
string Exemple: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59" |
eventThreadState |
Modifiable |
string Valeurs: "STARTED", "UPDATED", "ENDED" |
resourceGroup |
Objet indiquant les ressources susceptibles d'avoir des mises à jour similaires à 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 la section Événements pour en savoir plus sur les différents types d'événements et leur fonctionnement.
Erreurs
Le ou les codes d'erreur suivants peuvent être renvoyés par rapport à cette caractéristique:
Message d'erreur | RPC | Dépannage |
---|---|---|
L'image de l'appareil photo n'est plus disponible en 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 son expiration. |
L'ID de l'événement n'appartient pas à la caméra. | FAILED_PRECONDITION |
Utilisez le eventID correct renvoyé par l'événement enregistré. |
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.