Schéma CameraPerson
Nest Cam (ancienne)
sdm.devices.traits.CameraPerson
Cette caractéristique appartient à tous les appareils compatibles avec les événements de détection de personne.
Champs
Aucun champ n'est disponible pour cette caractéristique.
Commandes
Aucune commande n'est disponible pour cette caractéristique.
Événements
Personne
Mise à jour possibleUne personne a été détectée par la caméra.
Cet événement est compatible avec les notifications pouvant être mises à jour. 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
.
Présence d'une personne
Charge utile
{ "eventId" : "d9a2b0e9-8578-46f8-899a-d741975d1c5b",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.CameraPerson.Person
" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "QKlbpmRJYrfkoK3vyiiLoUuNry...", } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
"eventThreadState" : "STARTED",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }
Champs d'événement de personne
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 |
Ancienne Nest Cam Utilisez-la avec la commande GenerateImage pour télécharger l'image de l'appareil photo associée à cet événement. |
string Exemple: "QKlbpmRJYrfkoK3vyiiLoUuNry..." |
Champs de la charge utile de l'événement
Champ | Description | Type de données |
---|---|---|
eventId |
Identifiant unique de l'événement. | string Exemple: "d9a2b0e9-8578-46f8-899a-d741975d1c5b" |
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 mise à jour de la ressource. | object |
userId |
Identifiant unique et brouillé représentant 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 qui indique les ressources susceptibles de disposer de mises à jour similaires à celles de cet événement. La ressource de l'événement lui-même (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 la section Événements.
Erreurs
Les codes d'erreur suivants peuvent être renvoyés en lien avec cette caractéristique:
Message d'erreur | RPC | Dépannage |
---|---|---|
L'image de la caméra n'est plus disponible au téléchargement. | DEADLINE_EXCEEDED |
Les images des événements expirent 30 secondes après la publication de l'événement. Veillez à télécharger l'image avant son expiration. |
L'ID d'événement n'appartient pas à la caméra. | FAILED_PRECONDITION |
Utilisez la eventID correcte renvoyée par l'événement de l'appareil photo. |
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.