Schéma de trait de minuteur pour la maison connectée
action.devices.traits.Timer
: la caractéristique Minuteur représente un minuteur sur un appareil.
Par exemple, un contrôleur d'arrosage ou un interrupteur connecté peuvent intégrer un minuteur intégré. Cette caractéristique peut être utilisée pour contrôler un minuteur intégré sur des appareils, par exemple pour démarrer un nouveau minuteur, ou pour suspendre et annuler un minuteur, et pour demander combien de temps il reste.
Attributs d'appareil
Les appareils dotés de cette caractéristique peuvent signaler les attributs suivants dans le cadre de l'opération SYNC
. Pour en savoir plus sur la gestion des intents SYNC
, consultez la section Traitement des intents.
Attributs | Type | Description |
---|---|---|
maxTimerLimitSec |
Entier |
Obligatoire. Indique le délai le plus long disponible sur l'appareil, mesuré en secondes. |
commandOnlyTimer |
Booléen |
(Par défaut : Indique si l'appareil est compatible avec la communication unidirectionnelle (vrai) ou bidirectionnelle (faux). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ni à un état de rapport pour cette caractéristique. |
Exemples
Appareil avec un minuteur limité à deux heures.
{ "maxTimerLimitSec": 7200 }
Device STATES
Les entités dotées de cette caractéristique peuvent signaler les états suivants dans le cadre de l'opération QUERY
. Pour en savoir plus sur la gestion des intents QUERY
, consultez la section Traitement des intents.
États | Type | Description |
---|---|---|
timerRemainingSec |
Entier |
Obligatoire. Temps restant actuel en secondes (-1 ou [0, |
timerPaused |
Booléen |
"True" s'il existe un minuteur actif, mais qu'il est en pause. |
Exemples
Combien de temps reste-t-il sur le minuteur de l'appareil ? (non exécuté).
{ "timerRemainingSec": -1 }
Combien de temps reste-t-il sur le minuteur de l'appareil ? (en cours d'exécution).
{ "timerRemainingSec": 60 }
Combien de temps reste-t-il sur le minuteur de l'appareil ? (en veille).
{ "timerRemainingSec": 30, "timerPaused": true }
COMMANDS d'appareil
Les appareils dotés de cette caractéristique peuvent répondre aux commandes suivantes dans le cadre de l'opération EXECUTE
. Pour en savoir plus sur la gestion des intents EXECUTE
, consultez la section Traitement des intents.
action.devices.commands.TimerStart
Démarrer un nouveau minuteur.
Paramètres
Paramètres | Type | Description |
---|---|---|
timerTimeSec |
Entier |
Obligatoire. Durée du minuteur en secondes ; doit être comprise entre [1, |
Exemples
Règle le minuteur de l'appareil sur cinq minutes.
{ "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 300 } }
Erreurs associées
Une erreur s'est produite lors du démarrage du minuteur.
Valeurs acceptées :
noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration
action.devices.commands.TimerAdjust
Ajustez la durée du minuteur.
Paramètres
Paramètres | Type | Description |
---|---|---|
timerTimeSec |
Entier |
Obligatoire. Ajustement positif ou négatif du minuteur en secondes. Doit être compris entre [ |
Exemples
Ajoutez une minute au minuteur de l'appareil.
{ "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": 60 } }
Soustrait 30 secondes du minuteur de l'appareil.
{ "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": -30 } }
Erreurs associées
Une erreur s'est produite lors du réglage du minuteur.
Valeurs acceptées :
noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration
action.devices.commands.TimerPause
Mettre le minuteur en pause.
Paramètres
Paramètres | Type | Description |
---|---|---|
Aucune propriété |
Exemples
Mets en pause le minuteur de l'appareil.
{ "command": "action.devices.commands.TimerPause", "params": {} }
Erreurs associées
Une erreur s'est produite lors de la mise en pause du minuteur.
Valeurs acceptées :
noTimerExists
action.devices.commands.TimerResume
Relance le minuteur.
Paramètres
Paramètres | Type | Description |
---|---|---|
Aucune propriété |
Exemples
Relancez le minuteur de l'appareil.
{ "command": "action.devices.commands.TimerResume", "params": {} }
Erreurs associées
Une erreur s'est produite lors de la réactivation du minuteur.
Valeurs acceptées :
noTimerExists
action.devices.commands.TimerCancel
Annuler le minuteur.
Paramètres
Paramètres | Type | Description |
---|---|---|
Aucune propriété |
Exemples
Arrête le minuteur de l'appareil.
{ "command": "action.devices.commands.TimerCancel", "params": {} }
Erreurs associées
Une erreur s'est produite lors de l'arrêt du minuteur.
Valeurs acceptées :
noTimerExists