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: 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, |
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, |
Exemplos
Executar o timer do dispositivo por cinco minutos.
{ "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 300 } }
Erros relacionados
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 [ |
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 } }
Erros relacionados
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": {} }
Erros relacionados
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": {} }
Erros relacionados
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": {} }
Erros relacionados
Ocorreu um erro ao interromper o timer.
Os valores suportados são:
noTimerExists