Esquema da CameraSound

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

sdm.devices.traits.CameraSound

Essa característica pertence a qualquer dispositivo compatível com 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

Áudio

A câmera detectou som.

Evento de som

Payload

{
  "eventId" : "0b0f23f4-9bab-450c-be75-cea2a5616216",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraSound.Sound" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "gpCTMn9-oxfMhHqbyG-lgXlj_g..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Campos de evento de som

Campo Descrição Tipo de dados
eventSessionId Um ID fornecido para 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 ao evento.

 string
Exemplo: "gpCTMn9-oxfMhHqbyG-lgXlj_g..."

Campos de payload do evento

Campo Descrição Tipo de dados
eventId Identificador exclusivo do evento. string
Exemplo: "0b0f23f4-9bab-450c-be75-cea2a5616216"
timestamp A hora em que o evento ocorreu. string
Exemplo: "2019-01-01T00:00:01Z"
resourceUpdate Um objeto com informações sobre a atualização do recurso. object
userId Um identificador exclusivo e ofuscado que representa o usuário. string
Exemplo: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
resourceGroup Objeto que indica recursos que podem ter atualizações semelhantes a este 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 dele. Faça o download da imagem antes da data de validade.
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 de código de erro da API para ver a lista completa desses códigos.