Cette page a été traduite par l'API Cloud Translation.

Schéma CameraPerson

Nest Cam (ancienne) Nest Cam (Extérieur ou intérieur, batterie) Nest Cam avec projecteur Nest Cam (Intérieur - Nest filaire) 00}0} Doorbell0}.

sdm.devices.traits.CameraPerson

Cette caractéristique appartient à n'importe quel appareil compatible avec les événements de détection de personnes.

Champs

Aucun champ n'est disponible pour cette caractéristique.

Commandes

Aucune commande n'est disponible pour cette caractéristique.

Événements

Person

Modifiable

Une personne a été détectée par la caméra.

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 personne

Charge utile

{
  "eventId" : "d582ccc6-0de9-4cf3-a9ed-cc3b39218c97",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "M7S78ZiC4dTyGf_fPHczuRv26r...",
      }
    }
  }
  "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) Nest Doorbell (filaire) ID attribué aux événements qui se produisent au cours d'une même session d'événements associés. Peut être utilisé pour regrouper des événements. Utilisez-le pour associer cet événement à l'événement ClipPreview associé de la caractéristique CameraClipPreview.	`string` Exemple: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
`eventId`	Nest Cam (ancienne) Nest Hub Max Nest Doorbell (ancienne) Identifiant de l'événement. Utilisez-la avec la commande "GenerateImage" pour télécharger l'image de caméra associée à cet événement.	`string` Exemple: "M7S78ZiC4dTyGf_fPHczuRv26r..."

Champs de charge utile de l'événement

Champ	Description	Type de données
`eventId`	Identifiant unique de l'événement.	`string` Exemple: "d582ccc6-0de9-4cf3-a9ed-cc3b39218c97"
`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 Identifiant unique du thread de l'événement.	`string` Exemple: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
`eventThreadState`	Modifiable État du thread de l'événement.	`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.