Campainha (legada)

Nest Hello

Todas as Nest Doorbells legadas são compatíveis com a API Smart Device Management (SDM). Este dispositivo retorna o tipo DOORBELL:

sdm.devices.types.DOORBELL

A Google Nest Doorbell (legada) tem uma câmera, que funciona da mesma forma que uma tipo de dispositivo CÂMERA.

Características

Referência

As seguintes características, comandos ou eventos estão relacionados a este dispositivo:

CaracterísticasDescriçãoComandosEventos
CameraEventImageEssa característica pertence a qualquer dispositivo que oferece suporte à geração de imagens a partir de eventos.GenerateImage
CameraImageEssa característica pertence a qualquer dispositivo compatível com a captura de imagens.
CameraLiveStreamEssa característica pertence a qualquer dispositivo compatível com a transmissão ao vivo.GenerateRtspStream
ExtendRtspStream
StopRtspStream
CameraMotionEssa característica pertence a qualquer dispositivo que oferece suporte a eventos de detecção de movimento.Movimento
CameraPersonEssa característica pertence a qualquer dispositivo compatível com eventos de detecção de pessoas.Pessoa
CameraSoundEssa característica pertence a qualquer dispositivo que oferece suporte a eventos de detecção de som.Som
DoorbellChimeEssa característica pertence a qualquer dispositivo que oferece suporte a uma campainha e eventos de pressionamento relacionados.Carimbo
InformaçõesEssa característica pertence a qualquer dispositivo para informações relacionadas ao dispositivo.

JSON

A ausência de uma característica em uma resposta GET indica que a característica ou não está disponível para o dispositivo no momento. Consulte Tipos de dispositivo para mais opções informações imprecisas ou inadequadas.

{
  "type" : "sdm.devices.types.DOORBELL",
  "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.DoorbellChime" : {},
    "sdm.devices.traits.Info" : {
      "customName" : "My device"
    }
  }
}

Gerenciar eventos da campainha e da câmera

Os seguintes eventos podem ser acionados de um tipo de dispositivo DOORBELL :

Tipo Elemento Descrição
Evento Evento Motion do traço CameraMotion A câmera detectou movimento.
Evento Evento Person da característica CameraPerson Uma pessoa foi detectada pela câmera.
Evento Evento de som da característica CameraSound A câmera detectou som.
Evento Evento Chime da característica DoorbellChime A campainha foi pressionada.
Por exemplo, aqui o botão da campainha foi pressionado:

Payload

{
  "eventId" : "8cfbc540-68c8-42dd-9bb1-5b71c6ac7fa3",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.DoorbellChime.Chime" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "j1L8rc2B4PesaHP2zcdW6A-AwG..." } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }
O payload desse evento contém um eventId que pode ser usado com o GenerateImage kubectl. Esse comando retorna um URL de download da imagem da câmera relacionada ao evento:

Solicitação

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraEventImage.GenerateImage",
  "params" : {
    "eventId" : "HMy5lGCGEPspcfxKvpmxoiqf2i..."
  }
}

Resposta

{
  "results" : {
    "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "token" : "g.0.eventToken"
  }
}

Fazer o download de uma imagem da câmera

Faça uma chamada GET para o url de uma a resposta do comando GenerateImage, usando token no cabeçalho de autorização HTTP com autorização básica, para faça o download da imagem da câmera:

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...

Use os parâmetros de consulta width ou height para personalizar a resolução do imagem baixada. Somente um desses parâmetros precisa ser especificado. O outro é dimensionado automaticamente de acordo com a proporção da câmera.

Por exemplo, se a proporção da câmera for 4:3, faça o download da imagem da câmera com resolução de 480 x 360, especifique a largura ou a altura:

Largura

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?width=480

Altura

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?height=360

Outras restrições ao URL de download se aplicam:

  • Se ambos os parâmetros forem fornecidos no URL, width será usado e height. é ignorado.
  • Se nenhum parâmetro for fornecido no URL, o valor padrão 480 será escolhido para o width:

Confira as características de CameraImage para informações sobre propriedades da imagem.

Acessar uma transmissão ao vivo

A transmissão ao vivo de uma câmera pode ser acessada. Os seguintes formatos de transmissão são compatível com este dispositivo:

  • RTSP

Para acessar uma lista completa de câmeras e formatos de transmissão compatíveis, consulte Dispositivos compatíveis.

Para acessar uma transmissão ao vivo, use a opção "GerarFormatStream" da função CameraLiveStream característica.

RTSP

Para um fluxo RTSP, o Comando GenerateRtspStream do comando de característica do CameraLiveStream. retorna o URL do fluxo e o streamToken relacionado:

Solicitação

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.GenerateRtspStream",
  "params" : {}
}

Resposta

{
  "results" : {
    "streamUrls" : {
      "rtspUrl" : "rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken"
    },
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
    "streamToken" : "g.0.streamingToken",
    "expiresAt" : "2018-01-04T18:30:00.000Z"
  }
}

Em seguida, use esse URL para acessar a transmissão ao vivo da câmera:

rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken

Os URLs de transmissão ao vivo do RTSP não podem ser compartilhados entre clientes. Um URL de stream só pode ser usado por um cliente de cada vez. Se vários clientes quiserem transmitir da mesma câmera ao mesmo tempo, os comandos RTSP devem ser enviados para cada cliente individual e cada cliente deve usar o próprio URL de stream.

Estender uma transmissão ao vivo

As sessões de transmissão ao vivo da câmera só são válidas por 5 minutos. Se você precisar estender o ciclo de vida de uma transmissão ao vivo, use o comando "Estender"Format"Estender" da característica CameraLiveStream do formato de transmissão que você gerou.

RTSP

Para estender um stream RTSP, use o ExtendRtspStream do comando de característica do CameraLiveStream para receber novos streamExtensionToken e streamToken valores:

Solicitação

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.ExtendRtspStream",
  "params" : {
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
  }
}

Resposta

{
  "results" : {
    "streamExtensionToken" : "dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "streamToken" : "g.0.newStreamingToken",
    "expiresAt" : "2018-01-04T18:30:00.000Z"
  }
}

Atualize o URL de stream com esses novos valores para continuar visualizando o transmissão ao vivo:

rtsps://someurl.com/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?auth=g.0.newStreamingToken

Interromper uma transmissão ao vivo

Sempre que você não estiver mais usando a transmissão ao vivo da câmera, interrompa-a e e invalidar o stream. Para isso, use o fluxoFormatde parada adequado da função CameraLiveStream característica do formato de transmissão que você gerou.

RTSP

Para interromper um stream RTSP, use o token para invalidar com o StopRtspStream do comando de característica do CameraLiveStream:

Solicitação

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.StopRtspStream",
  "params" : {
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
  }
}

Resposta

{}

Erros

Os seguintes códigos de erro podem ser retornados em relação a este dispositivo:

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. 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 a lista completa de códigos de erro da API.