Schéma de trait Smart Home StartStop

action.devices.traits.StartStop : ce trait appartient aux appareils qui permettent de démarrer et d'arrêter des opérations.

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 ont simplement un état "activé" et "désactivé", 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 reprennent leur activité dans le même état que lorsqu'ils ont été mis en pause. La réactivation est différente du démarrage/redémarrage, car quelle que soit l'état actuel de l'appareil, l'opération commencera depuis le début.

Il est possible que certains appareils soient compatibles avec l'exécution dans certaines zones. Par exemple, un arroseur peut avoir différentes zones d'arrosage et permettre d'arroser certaines zones 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 Fulfillment d'intent.

Exemples

Appareil pouvant être mis en pause et fonctionnant dans plusieurs zones

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

ÉTATS des appareils

Les entités dotées de ce trait peuvent signaler les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez Fulfillment d'intent.

Exemples

L'appareil est-il suspendu ?

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

L'appareil est-il suspendu ?

{
  "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 Fulfillment d'intent.

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

Démarre l'appareil dans la cuisine, la salle à manger et le salon.

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

action.devices.commands.PauseUnpause

Mettre en pause ou reprendre 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 un appareil en veille, mais celui-ci se trouve dans un état qui ne le permet pas.

Valeurs acceptées :

unpausableState

Exemples d'énoncés

ERREURS liées à l'appareil