Schéma CameraSound

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

sdm.devices.traits.CameraSound

Cette caractéristique appartient à tous les appareils compatibles avec les événements de détection de son.

Champs

Aucun champ n'est disponible pour ce trait.

Commandes

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

Événements

Son

La caméra a détecté un son.

Événement sonore

Charge utile

{
  "eventId" : "65006b72-f169-4da9-9c18-b8239fe522d1",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraSound.Sound" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "f7tLGzBi2G2kkV77cUg1B0fnuv..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Champs de l'événement sonore

Champ	Description	Type de données
eventSessionId	Identifiant attribué aux événements qui se produisent au cours d'une session unique de événements associés. Peut être utilisé pour regrouper des événements.	string Exemple : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId	Identifiant associé à 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 : "f7tLGzBi2G2kkV77cUg1B0fnuv..."

Champs de charge utile de l'événement

Champ	Description	Type de données
eventId	Identifiant unique de l'événement.	string Exemple : "65006b72-f169-4da9-9c18-b8239fe522d1"
timestamp	L'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 qui représente l'utilisateur.	string Exemple : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
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 l'article Événements pour en savoir plus sur les différents types d'événements et comment ils fonctionnent.

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 l'appareil photo 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 le bon eventID 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.