Schéma du remplissage de la maison connectée

action.devices.traits.Fill : cette caractéristique s'applique aux appareils compatibles avec le remplissage, comme une baignoire.

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
availableFillLevels	Objet	Décrit les différents niveaux de remplissage de l'appareil.
levels	Array	Obligatoire. Liste des noms de niveau et des synonymes spécifiques à chaque langue.
[item, ...]	Objet	Nom du niveau et synonymes spécifiques à la langue
level_name	String	Obligatoire. Nom interne du niveau. Il n'est pas facile à utiliser et sera partagé dans toutes les langues.
level_values	Array	Obligatoire. Synonymes du niveau dans chaque langue acceptée.
[item, ...]	Objet	Synonymes du niveau dans une langue donnée.
level_synonym	Array	Obligatoire. Synonyme du niveau. La première chaîne de cette liste est utilisée comme nom canonique du niveau dans cette langue.
[item, ...]	String	Nom du synonyme.
lang	String	Obligatoire. Code de langue (ISO 639-1). Consultez la liste des langues acceptées.
ordered	Booléen	Obligatoire. Si la valeur est "true", l'appareil gère la grammaire supplémentaire permettant d'augmenter ou de diminuer la logique, comme indiqué par le tableau levels (demi-niveau, par exemple).
supportsFillPercent	Booléen	(Par défaut : false) Si la valeur est "true", acceptez les commandes permettant de régler le niveau sur un pourcentage.

Exemples

Appareil doté de fonctionnalités de remplissage ou de drainage qui ne sont pas compatibles avec différents niveaux de remplissage

{}

Appareil compatible avec différents niveaux de remplissage.

{
  "availableFillLevels": {
    "levels": [
      {
        "level_name": "half_level",
        "level_values": [
          {
            "level_synonym": [
              "Half",
              "Half way",
              "One half"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "level_name": "full_level",
        "level_values": [
          {
            "level_synonym": [
              "Full",
              "All the way",
              "Complete"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  }
}

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
isFilled	Booléen	Obligatoire. True si le niveau de l'appareil est rempli. Faux si l'appareil est complètement drainé.
currentFillLevel	String	Obligatoire si l'attribut availableFillLevels est défini. Indique la valeur level_name actuelle de l'attribut availableFillLevels auquel l'appareil est rempli.
currentFillPercent	Number	Obligatoire si l'attribut supportsFillPercent est défini. Indique le pourcentage actuel de remplissage.

Exemples

La baignoire est-elle remplie ?

{
  "isFilled": true
}

La baignoire est-elle remplie ? (avec des niveaux).

{
  "isFilled": true,
  "currentFillLevel": "half_level"
}

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.Fill

Remplissez ou déchargez l'appareil.

Paramètres

Paramètres	Type	Description
fill	Booléen	Obligatoire. Vrai pour remplir, faux pour décharger.
fillLevel	String	Indique la valeur level_name de l'attribut availableFillLevels à définir. Si aucune valeur n'est spécifiée, indiquez le niveau par défaut.
fillPercent	Number	Indique le pourcentage de niveau demandé.

Exemples

Remplissez la baignoire.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true
  }
}

Videz la baignoire.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": false
  }
}

Complétez la baignoire à mi-chemin.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "half_level"
  }
}

Augmentez le niveau de remplissage de la baignoire de un (l'attribut ordered doit être true).

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "full_level"
  }
}

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.