Schéma CameraMotion

Nest Cam (ancienne version) Nest Cam (Extérieur ou intérieur, batterie) Nest Cam avec projecteur Nest Cam (Intérieur - Filaire) Nest Hub Max Nest Doorbell (ancienne version) Nest Doorbell (batterie) Nest Doorbell (filaire)

sdm.devices.traits.CameraMotion

Cette caractéristique appartient à tout appareil compatible avec les événements de détection de mouvement.

Champs

Aucun champ n'est disponible pour ce trait.

Commandes

Aucune commande n'est disponible pour ce trait.

Événements

Mouvement

Mise à jour possible

Un mouvement a été détecté 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.

Événement "Mouvement"

Charge utile

{
  "eventId" : "4e6f0d12-01e0-47a7-bc0b-e637ba8e349a",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraMotion.Motion" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "xOoalWWKvAaz77l3zws30Gsq24...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Champs de l'événement "Mouvement"

Champ	Description	Type de données
`eventSessionId`	Nest Doorbell (batterie) Nest Doorbell (filaire) ID attribué aux événements qui se produisent dans le cadre 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 version) Nest Hub Max Nest Doorbell (ancienne version) ID associé à l'événement. Utilisez-le avec la commande GenerateImage pour télécharger l'image de la caméra associée à cet événement.	`string` Exemple : "xOoalWWKvAaz77l3zws30Gsq24..."

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

Champ	Description	Type de données
`eventId`	Identifiant unique de l'événement.	`string` Exemple : "4e6f0d12-01e0-47a7-bc0b-e637ba8e349a"
`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 modification de la ressource.	`object`
`userId`	Identifiant unique et obscurci représentant l'utilisateur.	`string` Exemple : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
`eventThreadId`	Mise à jour possible Identifiant unique du fil d'événements.	`string` Exemple : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
`eventThreadState`	Mise à jour possible État du fil d'événements.	`string` Valeurs : "STARTED", "UPDATED", "ENDED"
`resourceGroup`	Objet qui indique les ressources susceptibles d'avoir des modifications similaires de 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`

Pour en savoir plus sur les différents types d'événements et leur fonctionnement, consultez la section Événements.

Erreurs

Le ou les codes d'erreur suivants peuvent être renvoyés en relation avec ce trait :

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'événements 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 le `eventID` correct renvoyé par l'événement de la caméra.

Pour obtenir la liste complète des codes d'erreur de l'API, consultez la documentation de référence sur les codes d'erreur de l'API.