Schéma du trait StartStop pour la maison connectée

action.devices.traits.StartStop : ce trait appartient aux appareils compatibles avec les opérations de démarrage et d'arrêt.

Démarrer et arrêter un appareil vont de pair, tout comme allumer et éteindre un appareil. Les appareils qui héritent de ce trait fonctionnent différemment lorsqu'ils sont allumés et lorsqu'ils sont démarrés. Par exemple, il est possible d'allumer certaines machines à laver et de modifier leurs paramètres avant qu'elles ne démarrent.

Contrairement aux appareils qui ne peuvent être qu'allumés ou éteints, certains appareils qui peuvent démarrer et s'arrêter peuvent également être mis en pause pendant une opération. Les appareils qui peuvent être mis en pause cessent de fonctionner, mais lorsqu'ils reprennent, ils continuent dans le même état que lorsqu'ils ont été mis en pause. La reprise diffère du démarrage/redémarrage, car quel que soit l'état actuel de l'appareil, l'opération commencera depuis le début.

Certains appareils peuvent être compatibles avec l'exécution dans certaines zones. Par exemple, un arroseur peut avoir plusieurs zones d'arrosage et permettre d'arroser des zones spécifiques séparément, tandis qu'un aspirateur peut permettre de nettoyer des pièces spécifiques.

ATTRIBUTS de l'appareil

Les appareils dotés de ce trait peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Traitement des intents.

Exemples

Appareil pouvant être mis en pause et compatible avec un fonctionnement dans plusieurs zones.

{
  "pausable": true,
  "availableZones": [
    "Kitchen",
    "Living room",
    "Office",
    "Bedroom"
  ]
}

États des appareils

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.

Exemples

L'appareil est-il en pause ?

{
  "isRunning": false,
  "isPaused": true
}

L'appareil est-il en pause ?

{
  "isRunning": true,
  "isPaused": false
}

L'appareil est-il en cours d'exécution ?

{
  "isRunning": true,
  "isPaused": false,
  "activeZones": [
    "Kitchen",
    "Living room"
  ]
}

COMMANDES de l'appareil

Les appareils dotés de ce trait 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.StartStop

Démarrer ou arrêter l'appareil

Paramètres

Exemples

Démarrez l'appareil.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true
  }
}

Arrêtez l'appareil.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": false
  }
}

Démarrez l'appareil au bureau.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "zone": "office"
  }
}

Allume l'appareil dans la cuisine, la salle à manger et la salle de séjour.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "multipleZones": [
      "Kitchen",
      "Dining room",
      "Living room"
    ]
  }
}

action.devices.commands.PauseUnpause

Mettre en pause ou réactiver le fonctionnement de l'appareil.

{
  "pausable": true
}

Paramètres

Exemples

Mettez l'appareil en pause.

{
  "command": "action.devices.commands.PauseUnpause",
  "params": {
    "pause": true
  }
}

Erreurs associées

L'utilisateur a essayé de mettre en pause un appareil, mais celui-ci se trouve dans un état qui ne permet pas de le mettre en pause.

Valeurs acceptées :

unpausableState

Exemples d'énoncés

ERREURS de l'appareil