Esquema CameraSound

Nest Cam (legada) Nest Hub Max Nest Doorbell (legada) 

sdm.devices.traits.CameraSound

Essa característica pertence a qualquer dispositivo que oferece suporte a eventos de detecção de som.

Campos

Não há campos disponíveis para essa característica.

Comandos

Não há comandos disponíveis para essa característica.

Eventos

Som

A câmera detectou som.

Evento de som

Payload

{
  "eventId" : "3eebc125-a268-4349-924a-a62910339522",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.CameraSound.Sound" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "ni8yYi2m_3WP47O4zSBlZuZpKf..." } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }

Campos de eventos sonoros

Field Descrição Tipo de dados
eventSessionId Um ID dado a eventos que ocorrem como parte de uma única sessão de eventos relacionados. Pode ser usado para consolidar eventos. string
Exemplo: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId Um ID associado ao evento.

Use-o com o comando GenerateImage para fazer o download da imagem da câmera relacionada a este evento.

string
Exemplo: "ni8yYi2m_3WP47O4zSBlZuZpKf..."

Campos de payload de evento

Field Descrição Tipo de dados
eventId O identificador exclusivo do evento. string
Exemplo: "3eebc125-a268-4349-924a-a62910339522"
timestamp A hora em que o evento ocorreu. string
Exemplo: "2019-01-01T00:00:01Z"
resourceUpdate Um objeto que detalha informações sobre a atualização de recursos. object
userId Identificador exclusivo e ofuscado que representa o usuário. string
Exemplo: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
resourceGroup Um objeto que indica recursos que podem ter atualizações semelhantes a esse evento. O recurso do próprio evento (do objeto resourceUpdate) sempre estará presente nesse objeto. object

Consulte Eventos para mais informações sobre os diferentes tipos de eventos e como eles funcionam.

Erros

Os seguintes códigos de erro podem ser retornados em relação a essa característica:

Mensagem de erro RPC Solução de problemas
A imagem da câmera não está mais disponível para download. DEADLINE_EXCEEDED As imagens do evento expiram 30 segundos após a publicação do evento. Faça o download da imagem antes que ela expire.
O ID do evento não pertence à câmera. FAILED_PRECONDITION Use a eventID correta retornada pelo evento da câmera.

Consulte a Referência do código de erro da API para ver a lista completa de códigos de erro de API.