Schéma de la fonction de minuteur pour la maison connectée

action.devices.traits.Timer : la caractéristique Minuteur représente un minuteur sur un appareil.

Par exemple, une manette d'arrosage intelligente ou un interrupteur connecté peut être doté d'un minuteur intégré. Vous pouvez utiliser cette caractéristique pour contrôler un minuteur intégré sur des appareils, par exemple pour démarrer un nouveau minuteur, ou pour mettre en pause et annuler un minuteur en cours d'exécution, et pour demander le temps restant.

ATTRIBUTS de l'appareil

Les appareils disposant de cette caractéristique peuvent signaler les attributs suivants lors de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Traitement des intents.

Attributs Type Description
maxTimerLimitSec Entier

Obligatoire.

Indique le paramètre de minuteur le plus long disponible sur l'appareil, mesuré en secondes.
commandOnlyTimer Booléen

(Par défaut : false)

Indique si l'appareil est compatible avec la communication unidirectionnelle (true) ou bidirectionnelle (false). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ou Report Report pour cette caractéristique.

Exemples

Appareil avec un délai de deux heures.

{
  "maxTimerLimitSec": 7200
}

Appareil 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 Traitement des intents.

États Type Description
timerRemainingSec Entier

Obligatoire.

Temps restant (en secondes, -1 ou [0, maxTimerLimitSec]). Définissez la valeur sur -1 pour indiquer qu'aucun minuteur n'est en cours d'exécution.
timerPaused Booléen

Défini sur "true" si un minuteur actif existe, mais est actuellement en pause.

Exemples

Combien de temps reste-t-il sur le minuteur de l'appareil ? (pas en cours d'exécution).

{
  "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 pause).

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

Appareil COMMANDS

Les appareils disposant 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 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. Elle doit être comprise dans la plage [1, maxTimerLimitSec].

Exemples

Exécutez le minuteur de l'appareil pendant cinq minutes.

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

Une erreur s'est produite au 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. Il doit être compris entre [-maxTimerLimitSec et maxTimerLimitSec].

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
  }
}

Une erreur s'est produite lors du réglage du minuteur.

Valeurs acceptées :

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerPause

Mets le minuteur en pause.

Paramètres

Paramètres Type Description

Aucune propriété

Exemples

Suspendez le minuteur de l'appareil.

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

Une erreur s'est produite lors de la mise en pause du minuteur.

Valeurs acceptées :

noTimerExists

action.devices.commands.TimerResume

Reprendre le minuteur.

Paramètres

Paramètres Type Description

Aucune propriété

Exemples

Reprends le minuteur de l'appareil.

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

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": {}
}

Une erreur s'est produite lors de l'arrêt du minuteur.

Valeurs acceptées :

noTimerExists

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.