L'écran Google Nest Hub Max est compatible avec l'API Smart Device Management (SDM). Cet appareil renvoie un type d'appareil DISPLAY:
sdm.devices.types.DISPLAY
Google Nest Hub Max est doté d'une caméra qui fonctionne de la même manière qu'un appareil de type CAMERA.
Caractéristiques
Reference
Les caractéristiques, commandes ou événements suivants sont associés à cet appareil:
Trait | Description | Commandes | Événements |
---|---|---|---|
CameraEventImage | Cette caractéristique appartient à n'importe quel appareil compatible avec la génération d'images à partir d'événements. | GenerateImage | |
CameraImage | Cette caractéristique appartient à n'importe quel appareil compatible avec la prise d'images. | ||
CameraLiveStream | Cette caractéristique appartient à n'importe quel appareil compatible avec le streaming en direct. | GenerateRtspStream ExtendRtspStream StopRtspStream | |
CameraMotion | Cette caractéristique appartient à n'importe quel appareil prenant en charge les événements de détection de mouvement. | Mouvement | |
CameraPerson | Cette caractéristique appartient à n'importe quel appareil compatible avec les événements de détection de personnes. | Personne | |
CameraSound | Cette caractéristique appartient à n'importe quel appareil compatible avec les événements de détection des sons. | Son | |
Infos | Cette caractéristique appartient à n'importe quel appareil pour les informations liées à l'appareil. |
JSON
L'absence d'un trait dans une réponse GET indique que le trait ou la caractéristique en question n'est pas disponible actuellement pour l'appareil. Pour plus d'informations, consultez la section Types d'appareils.
{ "type" : "sdm.devices.types.DISPLAY", "traits" : { "sdm.devices.traits.CameraEventImage" : {}, "sdm.devices.traits.CameraImage" : { "maxImageResolution" : { "width" : 1280, "height" : 960 } }, "sdm.devices.traits.CameraLiveStream" : { "maxVideoResolution" : { "width" : 640, "height" : 480 }, "videoCodecs" : ["H264"], "audioCodecs" : ["AAC"], "supportedProtocols" : ["WEB_RTC"] }, "sdm.devices.traits.CameraMotion" : {}, "sdm.devices.traits.CameraPerson" : {}, "sdm.devices.traits.CameraSound" : {}, "sdm.devices.traits.Info" : { "customName" : "My device" } } }
Gérer les événements enregistrés
Les événements suivants peuvent être déclenchés à partir d'un type d'appareil DISPLAY:Type | Élément | Description |
---|---|---|
Événement | Événement Motion de la caractéristique CameraMotion | La caméra a détecté un mouvement. |
Événement | Événement Person du trait CameraPerson | Une personne a été détectée par la caméra. |
Événement | Événement Son de la caractéristique CameraSound | La caméra a détecté un son. |
Charge utile
{ "eventId" : "0334f8ca-3c01-42ec-82d4-c6232f436879",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.CameraMotion.Motion
" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "xuXvMMR68-rWLA4Yb3k8NiVveX...", } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }
eventId
qui peut être utilisé avec la commande GenerateImage. Cette commande renvoie une URL de téléchargement pour l'image de la caméra liée à l'événement:
Requête
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.CameraEventImage.GenerateImage
",
"params" : {
"eventId" : "baEUplCXqgF0UbGyThFhPi3SA-..."
}
}
Réponse
{ "results" : { "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...", "token" : "g.0.eventToken" } }
Télécharger l'image d'un appareil photo
Envoyez un appel GET à url
à partir d'une réponse de commande GenerateImage, en utilisant token
dans l'en-tête d'autorisation HTTP avec une autorisation de base pour télécharger l'image de l'appareil photo:
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...
Utilisez les paramètres de requête width
ou height
pour personnaliser la résolution de l'image téléchargée. Un seul de ces paramètres doit être spécifié. L'autre paramètre est mis à l'échelle automatiquement en fonction du format de l'appareil photo.
Par exemple, si le format de la caméra est 4:3, spécifiez la largeur ou la hauteur pour télécharger l'image de la caméra à une résolution de 480 x 360:
Largeur
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?width=480
Taille
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?height=360
D'autres restrictions s'appliquent à l'URL de téléchargement:
- Si les deux paramètres sont fournis dans l'URL,
width
est utilisé etheight
est ignoré. - Si aucun paramètre n'est fourni dans l'URL, la valeur par défaut 480 est choisie pour
width
.
Consultez la caractéristique CameraImage pour en savoir plus sur les propriétés de l'image.
Accéder à une diffusion en direct
Le flux en direct d'une caméra est accessible. Les formats de flux suivants sont compatibles avec cet appareil:
- RTSP
Pour obtenir la liste complète des caméras et des formats de flux compatibles, consultez la section Appareils compatibles.
Pour accéder à une diffusion en direct, utilisez la commande GenerateFormatStream appropriée de la caractéristiqueCameraLiveStream.
RTSP
Pour un flux RTSP, la commande GenerateRtspStream de la commande de trait CameraLiveStream renvoie l'URL du flux et le streamToken
associé:
Requête
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.CameraLiveStream.GenerateRtspStream
",
"params" : {}
}
Réponse
{ "results" : { "streamUrls" : { "rtspUrl" : "rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken" }, "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "streamToken" : "g.0.streamingToken", "expiresAt" : "2018-01-04T18:30:00.000Z" } }
Utilisez ensuite l'URL du flux pour accéder au flux en direct de la caméra:
rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken
Les URL de flux en direct RTSP ne peuvent pas être partagées entre les clients. Une URL de flux ne peut être utilisée que par un client à la fois. Si plusieurs clients souhaitent diffuser un flux depuis la même caméra en même temps, les commandes RTSP doivent être envoyées pour chacun d'entre eux, et chacun d'eux doit utiliser sa propre URL de flux.
Prolonger une diffusion en direct
Les sessions de streaming en direct avec la caméra ne sont valides que pendant cinq minutes. Si vous avez besoin de prolonger la durée de vie d'un flux en direct, utilisez la commande ExtendFormatStream appropriée de la caractéristique CameraLiveStream pour le format de flux que vous avez généré.
RTSP
Pour étendre un flux RTSP, utilisez la commande ExtendRtspStream de la commande de trait CameraLiveStream afin d'obtenir les nouvelles valeurs streamExtensionToken
et streamToken
:
Requête
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.CameraLiveStream.ExtendRtspStream
",
"params" : {
"streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
}
}
Réponse
{ "results" : { "streamExtensionToken" : "dGNUlTU2CjY5Y3VKaTZwR3o4Y1...", "streamToken" : "g.0.newStreamingToken", "expiresAt" : "2018-01-04T18:30:00.000Z" } }
Mettez à jour l'URL du flux avec ces nouvelles valeurs pour continuer à regarder le flux en direct:
rtsps://someurl.com/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?auth=g.0.newStreamingToken
Arrêter une diffusion en direct
Chaque fois que vous n'utilisez plus le flux en direct d'une caméra, vous devez l'arrêter et l'invalider. Pour ce faire, utilisez la commande StopFormatStream appropriée de la caractéristiqueCameraLiveStreampour le format de flux que vous avez généré.
RTSP
Pour arrêter un flux RTSP, utilisez le jeton pour l'invalider avec la commande StopRtspStream de la commande de trait CameraLiveStream:
Requête
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.CameraLiveStream.StopRtspStream
",
"params" : {
"streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
}
}
Réponse
{}
Erreurs
Le ou les codes d'erreur suivants peuvent être renvoyés concernant cet appareil:
Message d'erreur | RPC | Dépannage |
---|---|---|
L'image de l'appareil photo ne peut plus être téléchargée. | DEADLINE_EXCEEDED |
Les images d'un événement expirent 30 secondes après sa 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 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.