Esquema CameraPerson

Nest Cam (legada) Nest Cam (interna ou externa, com bateria) Nest Cam com holofote Nest Cam Doorbell2 Max0 (com fio, com fio) Doorbell{/1 Max1 Max1 Max1 Max1

sdm.devices.traits.CameraPerson

Essa característica pertence a qualquer dispositivo compatível com eventos de detecção de pessoas.

Campos

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

Comandos

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

Eventos

Pessoa

Atualizável 

Uma pessoa foi detectada pela câmera.

Este evento é compatível com notificações atualizáveis. As notificações de apps existentes criadas com base nesse evento podem ser atualizadas usando o conteúdo de um evento subsequente com o mesmo eventThreadId.

Evento da pessoa

Payload

{
  "eventId" : "38f30d3a-613c-425b-8e23-75573e939590",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "JxqJoSqaiCU1CshsXAEfUaVAEb...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Campos de evento de pessoa

Field Descrição Tipo de dados
eventSessionId Nest Doorbell (com bateria) Nest Doorbell (com fio) Um ID fornecido a eventos que ocorrem como parte de uma única sessão de eventos relacionados. Pode ser usado para consolidar eventos.

Use-o para associar esse evento ao evento ClipPreview relacionado da característica CameraClipPreview.

 string
Exemplo: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId Nest Cam (legado) Nest Hub Max Nest Doorbell (legado) 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: "JxqJoSqaiCU1CshsXAEfUaVAEb..."

Campos de payload de evento

Field Descrição Tipo de dados
eventId O identificador exclusivo do evento. string
Exemplo: "38f30d3a-613c-425b-8e23-75573e939590"
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"
eventThreadId Atualizável O identificador exclusivo da linha de execução de eventos. string
Exemplo: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState Atualizável O estado da linha de execução de eventos. string
Valores: "STARTED", "UPDATED", "ENDED"
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.