Schéma CameraSound

Nest Cam (ancienne version) Nest Hub Max Nest Doorbell (ancienne version) 

sdm.devices.traits.CameraSound

Ce trait appartient à tout appareil compatible avec les événements de détection du son.

Champs

Aucun champ n'est disponible pour ce trait.

Commandes

Aucune commande n'est disponible pour ce trait.

Événements

Son

Un son a été détecté par la caméra.

Événement sonore

Charge utile

{
  "eventId" : "302c9c21-1fb8-4cfd-bbb6-62729f1f2063",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraSound.Sound" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "VrxJdyiOW0hvA_izx3hqQMOcD5..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Champs d'événement sonore

Champ Description Type de données
eventSessionId 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. string
Exemple : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId 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 : "VrxJdyiOW0hvA_izx3hqQMOcD5..."

Champs de charge utile des événements

Champ Description Type de données
eventId Identifiant unique de l'événement. string
Exemple : "302c9c21-1fb8-4cfd-bbb6-62729f1f2063"
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 obscurci représentant l'utilisateur. string
Exemple : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
resourceGroup Objet qui indique 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

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

Erreurs

Les codes d'erreur suivants peuvent être renvoyés en lien 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 la publication de l'événement. Assurez-vous de 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 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.