Esquema do DoorbellChime
Nest Doorbell (legada)
sdm.devices.traits.DoorbellChime
Essa característica pertence a qualquer dispositivo com suporte à campainha e a eventos relacionados.
Campos
Não há campos disponíveis para essa característica.
Comandos
Não há comandos disponíveis para essa característica.
Eventos
Campainha
AtualizávelA campainha foi pressionada.
Este evento é compatível com notificações atualizáveis. As notificações de apps criadas com base nesse evento podem ser atualizadas usando o conteúdo de um evento subsequente com o mesmo eventThreadId
.
Evento da campainha
Payload
{ "eventId" : "854a3723-c351-45df-95e9-aed6004c1352",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.DoorbellChime.Chime
" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "mq-qjzq6wgrOPERrPw7OMmBZPN..." } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
"eventThreadState" : "STARTED",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }
Campos de evento da campainha
Campo | Descrição | Tipo de dados |
---|---|---|
eventSessionId |
Nest Doorbell (com bateria) Use-o para associar o evento ao ClipPreview relacionado da característica CameraClipPreview. |
string Exemplo: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..." |
eventId |
Nest Doorbell (legada) Use-o com o comando GenerateImage para fazer o download da imagem da câmera relacionada ao evento. |
string Exemplo: "mq-qjzq6wgrOPERrPw7OMmBZPN..." |
Campos de payload do evento
Campo | Descrição | Tipo de dados |
---|---|---|
eventId |
Identificador exclusivo do evento. | string Exemplo: "854a3723-c351-45df-95e9-aed6004c1352" |
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" |
eventThreadId |
Updateable |
string Exemplo: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59" |
eventThreadState |
Updateable |
string Valores: "STARTED", "UPDATED", "ENDED" |
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.