Ti diamo il benvenuto nel Centro sviluppatori Google Home, la nuova destinazione per imparare a sviluppare azioni per la smart home. Nota:continuerai a creare azioni nella Console Actions.
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Schema del tratto timer per la smart home

action.devices.traits.Timer: la caratteristica Timer rappresenta un timer su un dispositivo.

Ad esempio, un controller per irrigatori smart o un interruttore per la luce smart potrebbero avere un timer integrato. Questa caratteristica può essere utilizzata per controllare un timer integrato sui dispositivi, ad esempio avviare un nuovo timer, nonché mettere in pausa e annullare un timer in esecuzione e richiedere quanto tempo rimane.

ATTRIBUTE di dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta fulfillment degli intent.

Attributi Tipo Descrizione
maxTimerLimitSec Intero

Obbligatorio.

Indica l'impostazione del timer più lunga disponibile sul dispositivo, misurata in secondi.

commandOnlyTimer Booleano

(valore predefinito: false)

Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (falso). Imposta questo attributo su "true" se il dispositivo non può rispondere a un intent QUERY o a uno Stato del report per questa caratteristica.

Esempi

Dispositivo con limite di due ore per il timer.

{
  "maxTimerLimitSec": 7200
}

Dispositivo STATES

I dispositivi con questa caratteristica potrebbero segnalare i seguenti stati come parte dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta fulfillment degli intent.

Stati Tipo Descrizione
timerRemainingSec Intero

Obbligatorio.

Tempo corrente rimanente in secondi, -1 o [0, maxTimerLimitSec]. Imposta su -1 per indicare che non è in corso alcun timer.

timerPaused Booleano

Vero se esiste un timer attivo ma è attualmente in pausa.

Esempi

Quanto tempo rimane sul timer del dispositivo? (non in esecuzione).

{
  "timerRemainingSec": -1
}

Quanto tempo rimane sul timer del dispositivo? (in esecuzione).

{
  "timerRemainingSec": 60
}

Quanto tempo rimane sul timer del dispositivo? (in pausa).

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

COMANDI sul dispositivo

I dispositivi con questa caratteristica possono rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta fulfillment degli intent.

action.devices.commands.TimerStart

Avvia un nuovo timer.

Parametri

Parametri Tipo Descrizione
timerTimeSec Intero

Obbligatorio.

Durata del timer in secondi; deve essere entro [1, maxTimerLimitSec].

Esempi

Esegui il timer del dispositivo per cinque minuti.

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

Si è verificato un errore durante l'avvio del timer.

Valori supportati:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerAdjust

Regola la durata del timer.

Parametri

Parametri Tipo Descrizione
timerTimeSec Intero

Obbligatorio.

Regolazione positiva o negativa del timer in secondi; deve essere entro [-maxTimerLimitSec, maxTimerLimitSec].

Esempi

Aggiungi un minuto al timer del dispositivo.

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

Sottrae 30 secondi dal timer del dispositivo.

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

Si è verificato un errore durante la modifica del timer.

Valori supportati:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerPause

Metterà in pausa il timer.

Parametri

Parametri Tipo Descrizione

Nessuna proprietà

Esempi

Metti in pausa il timer del dispositivo.

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

Si è verificato un errore durante la messa in pausa del timer.

Valori supportati:

noTimerExists

action.devices.commands.TimerResume

Riprendi il timer.

Parametri

Parametri Tipo Descrizione

Nessuna proprietà

Esempi

Riprendi il timer del dispositivo.

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

Si è verificato un errore durante la riattivazione del timer.

Valori supportati:

noTimerExists

action.devices.commands.TimerCancel

Annullare il timer.

Parametri

Parametri Tipo Descrizione

Nessuna proprietà

Esempi

Interrompi il timer del dispositivo.

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

Si è verificato un errore durante l'interruzione del timer.

Valori supportati:

noTimerExists

ERRORS dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.