Schéma de trame de minuterie pour 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 intelligent ou une ampoule connectée peut disposer d'un minuteur intégré. Cette caractéristique peut être utilisée pour contrôler un minuteur intégré sur appareils. Par exemple, pour lancer un nouveau minuteur, ou suspendre ou annuler un minuteur en cours d'exécution, et en demandant combien de temps il reste.

ATTRIBUTS D'appareils

Les appareils présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération SYNC. Pour apprendre 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 Valeur booléenne

(Par défaut : false)

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 ou à l'état du rapport pour cette caractéristique.

Exemples

Appareil avec une limite de 2 heures de minuteur.

{
  "maxTimerLimitSec": 7200
}

STATES de l'appareil

Les entités présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération QUERY. Pour apprendre Pour en savoir plus sur la gestion des intents QUERY, consultez Traitement des intents.

États Type Description
timerRemainingSec Entier

Obligatoire.

Temps restant actuel en secondes, -1 ou [0, maxTimerLimitSec]. Réglez sur -1 pour indiquer qu'aucun minuteur n'est en cours.

timerPaused Valeur booléenne

"True" si un minuteur actif existe, mais est actuellement en pause.

Exemples

Combien de temps reste-t-il avant la mise en veille de l'appareil ? (non exécutée).

{
  "timerRemainingSec": -1
}

Combien de temps reste-t-il avant la mise en veille de l'appareil ? (en cours d'exécution).

{
  "timerRemainingSec": 60
}

Combien de temps reste-t-il avant la mise en veille de l'appareil ? (en pause).

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

COMMANDS d'appareils

Les appareils présentant cette caractéristique peuvent répondre aux éléments suivants : dans le cadre de l'opération EXECUTE. Pour apprendre Pour en savoir plus sur la gestion des intents EXECUTE, consultez Traitement des intents.

action.devices.commands.TimerStart

Démarrez un nouveau minuteur.

Paramètres

Paramètres Type Description
timerTimeSec Entier

Obligatoire.

Durée de la minuterie, en secondes. doit être compris dans la plage [1, maxTimerLimitSec].

Exemples

Lance le minuteur de l'appareil pendant cinq minutes.

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

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 dans la plage [-maxTimerLimitSec, maxTimerLimitSec].

Exemples

Ajoute 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

Mets en pause 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

Relance le minuteur.

Paramètres

Paramètres Type Description

Aucune propriété

Exemples

Relance 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 d'appareil

Voir la liste complète les erreurs et les exceptions.