Schéma CameraClipPreview

Nest Doorbell (batterie) Nest Doorbell (filaire) 

sdm.devices.traits.CameraClipPreview

Cette caractéristique appartient à tous les appareils compatibles avec le téléchargement d'un extrait.

Champs

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

Commandes

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

Événements

ClipPreview

Un extrait vidéo est disponible en aperçu.

Un aperçu d'extrait est un fichier vidéo de 10 images au format MP4. Vous pouvez choisir d'afficher le fichier vidéo MP4 ou de le transcoder vers un autre format (par exemple, un GIF animé) afin d'afficher une séquence complète de 10 cadres. Vous devez tenir compte des fonctionnalités du client de l'appareil lorsque vous sélectionnez une méthode d'aperçu du clip.

Cet événement est accepté pour les événements suivants:

Type Élément Description
Événement Événement Mouvement de la caractéristique CameraMotion Un mouvement a été détecté par la caméra.
Événement Événement Person de la caractéristique CameraPerson Une personne a été détectée par la caméra.
Événement Événement Carillon de la caractéristique DoorbellChime La sonnette a été déclenchée.
Utilisez eventSessionId pour associer cet événement et le previewUrl associé à un ou plusieurs événements compatibles.

Événement ClipPreview

Charge utile

{
  "eventId" : "fee9d372-2c10-43ae-96d5-4990e9abc1c6",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.CameraClipPreview.ClipPreview" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "previewUrl" : "https://previewUrl/..." } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }

Champs d'événement ClipPreview

Champ Description Type de données
eventSessionId ID attribué aux événements qui se produisent au cours d'une seule session d'événements associés. Peut être utilisé pour consolider des événements. string
Exemple: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
previewUrl URL à laquelle prévisualiser l'extrait vidéo. Le codec vidéo par défaut est H.264. string
Exemple: "https://previewUrl/..."

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

Champ Description Type de données
eventId Identifiant unique de l'événement. string
Exemple: "fee9d372-2c10-43ae-96d5-4990e9abc1c6"
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 brouillé représentant l'utilisateur. string
Exemple: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
resourceGroup Objet qui indique les ressources susceptibles de disposer de mises à jour similaires à celles de cet événement. La ressource de l'événement lui-même (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.

Prévisualiser l'extrait

Pour prévisualiser l'extrait, effectuez un appel GET à previewUrl à l'aide du jeton d'accès OAuth dans l'en-tête d'autorisation HTTP:

Aperçu

curl -H 'Authorization: Bearer access-token' \
  https://previewUrl/...

Erreurs

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.