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, filaire) Nest Hub Max Nest Doorbell (ancienne) Nest Doorbell (batterie) Nest Doorbell (filaire)

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 ce trait.

Événements

Personne

Mise à jour possible

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

Cet événement accepte 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.

Personne

Charge utile

{
  "eventId" : "f9c3bc98-4634-46d3-b33c-e21be073f51b",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "7l99VoXVtek6oiPimUrMmcUTJ8...",
      }
    }
  }
  "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 consolider 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 version) Nest Hub Max Nest Doorbell (ancienne version) ID associé à l'événement. Utilisez-la avec la commande GenerateImage pour télécharger l'image de l'appareil photo associée à cet événement.	`string` Exemple: "7l99VoXVtek6oiPimUrMmcUTJ8..."

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

Champ	Description	Type de données
`eventId`	Identifiant unique de l'événement.	`string` Exemple: "f9c3bc98-4634-46d3-b33c-e21be073f51b"
`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 d'événement.	`string` Exemple : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
`eventThreadState`	Modifiable État du thread d'événement.	`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 la page É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 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 d'un événement expirent 30 secondes après leur publication. 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.