Esquema de características do timer de casa inteligente

action.devices.traits.Timer: a característica de timer representa um timer no dispositivo.

Por exemplo, um controle de sprinkler inteligente ou um interruptor de iluminação inteligente podem ter um timer integrado. Essa característica pode ser usada para controlar um timer integrado nos dispositivos, por exemplo, iniciar um novo, pausar e cancelar um em execução e perguntar quanto tempo resta.

ATRIBUTOS do dispositivo

Dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre o gerenciamento de intents SYNC, consulte fulfillment de intents.

Atributos Tipo Descrição
maxTimerLimitSec Número inteiro

Obrigatório.

Indica a configuração do timer mais longo disponível no dispositivo, medida em segundos.

commandOnlyTimer Booleano

Padrão: false.

Indica se o dispositivo oferece suporte ao uso de comunicação unidirecional (verdadeiro) ou bidirecional (falso). Defina esse atributo como verdadeiro se o dispositivo não puder responder a uma intent QUERY ou ao estado do relatório dessa característica.

Exemplos

Dispositivo com limite de timer de duas horas.

{
  "maxTimerLimitSec": 7200
}

STATES do dispositivo

Entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o gerenciamento de intents QUERY, consulte fulfillment de intents.

Estados Tipo Descrição
timerRemainingSec Número inteiro

Obrigatório.

Tempo restante em segundos, -1 ou [0, maxTimerLimitSec]. Defina como -1 para indicar que nenhum timer está em execução.

timerPaused Booleano

Verdadeiro se existir um timer ativo, mas estiver pausado no momento.

Exemplos

Quanto tempo falta no timer do dispositivo? (não está em execução).

{
  "timerRemainingSec": -1
}

Quanto tempo falta no timer do dispositivo? (em execução).

{
  "timerRemainingSec": 60
}

Quanto tempo falta no timer do dispositivo? (pausado).

{
  "timerRemainingSec": 30,
  "timerPaused": true
}

Comandos do dispositivo

Dispositivos com essa característica podem responder aos seguintes comandos como parte da operação EXECUTE. Para saber mais sobre o gerenciamento de intents EXECUTE, consulte fulfillment de intents.

action.devices.commands.TimerStart

Inicie um novo cronômetro.

Parâmetros

Parâmetros Tipo Descrição
timerTimeSec Número inteiro

Obrigatório.

A duração do timer em segundos precisa ser de [1, maxTimerLimitSec].

Exemplos

Executar o timer do dispositivo por cinco minutos.

{
  "command": "action.devices.commands.TimerStart",
  "params": {
    "timerTimeSec": 300
  }
}

Ocorreu um erro ao iniciar o timer.

Os valores suportados são:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerAdjust

Ajuste a duração do timer.

Parâmetros

Parâmetros Tipo Descrição
timerTimeSec Número inteiro

Obrigatório.

Ajuste positivo ou negativo do timer em segundos. Deve estar dentro de [-maxTimerLimitSec, maxTimerLimitSec].

Exemplos

Adicione um minuto ao timer do dispositivo.

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": 60
  }
}

Subtrai 30 segundos do timer do dispositivo.

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": -30
  }
}

Ocorreu um erro ao ajustar o timer.

Os valores suportados são:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerPause

Pausar o cronômetro.

Parâmetros

Parâmetros Tipo Descrição

Não há propriedades

Exemplos

Pause o timer do dispositivo.

{
  "command": "action.devices.commands.TimerPause",
  "params": {}
}

Ocorreu um erro ao pausar o timer.

Os valores suportados são:

noTimerExists

action.devices.commands.TimerResume

Retomar timer.

Parâmetros

Parâmetros Tipo Descrição

Não há propriedades

Exemplos

Retome o timer do dispositivo.

{
  "command": "action.devices.commands.TimerResume",
  "params": {}
}

Ocorreu um erro ao retomar o timer.

Os valores suportados são:

noTimerExists

action.devices.commands.TimerCancel

Cancelar o timer.

Parâmetros

Parâmetros Tipo Descrição

Não há propriedades

Exemplos

Pare o timer do dispositivo.

{
  "command": "action.devices.commands.TimerCancel",
  "params": {}
}

Ocorreu um erro ao interromper o timer.

Os valores suportados são:

noTimerExists

ERROS DO Dispositivo

Veja a lista completa de erros e exceções.