Schéma de trait de remplissage pour la maison connectée

action.devices.traits.Fill : cette caractéristique s'applique aux appareils pouvant être remplis, comme une baignoire.

ATTRIBUTS de l'appareil

Les appareils présentant cette caractéristique peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez la section 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 niveaux et des synonymes spécifiques à une langue.
[item, ...] Objet

Nom du niveau et synonymes spécifiques à la langue.
level_name String

Obligatoire.

Nom interne du niveau. Cette approche peut ne pas être conviviale et sera utilisée dans toutes les langues.
level_values Array

Obligatoire.

Synonyme du niveau dans chaque langue prise en charge.
[item, ...] Objet

Synonyme 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

Synonyme du nom.
lang String

Obligatoire.

Code de langue (ISO 639-1) Consultez la liste des langues acceptées.
ordered Valeur booléenne

Obligatoire.

Si la valeur est "true", l'appareil gère une grammaire supplémentaire pour la logique d'augmentation ou de diminution, comme représenté par le tableau levels (par exemple, demi-niveau).
supportsFillPercent Valeur booléenne

(Par défaut : false)

Si la valeur est définie sur "true", acceptez les commandes permettant d'ajuster le niveau à un pourcentage.

Exemples

Appareil avec des fonctionnalités de remplissage ou de vidange de base qui ne sont pas compatibles avec des niveaux de remplissage distincts.

{}

Appareil compatible avec des niveaux de remplissage distincts.

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

ÉTATS DE L'APPAREIL

Les entités avec 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 la section Traitement des intents.

États Type Description
isFilled Valeur booléenne

Obligatoire.

"True" si l'appareil est rempli à n'importe quel niveau. "False" si l'appareil est complètement déchargé.
currentFillLevel String

Obligatoire si l'attribut availableFillLevels est défini. Indique l'level_name actuel de l'attribut availableFillLevels à partir duquel l'appareil est rempli.
currentFillPercent Number

Obligatoire si l'attribut supportsFillPercent est défini. Indique le pourcentage de remplissage actuel.

Exemples

La baignoire est-elle remplie ?

{
  "isFilled": true
}

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

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

COMMANDES DE L'APPAREIL

Les appareils dotés 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 la section Traitement des intents.

action.devices.commands.Fill

Remplir ou vider l'appareil

Paramètres

Paramètres Type Description
fill Valeur booléenne

Obligatoire.

"True" pour remplir, "false" pour vider.
fillLevel String

Indique le level_name de l'attribut availableFillLevels à définir. Si aucune valeur n'est spécifiée, le remplissage est effectué au niveau par défaut.
fillPercent Number

Indique le pourcentage de niveau demandé.

Exemples

Remplir la baignoire

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

Videz la baignoire.

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

Remplissez la baignoire à moitié.

{
  "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 défini sur true).

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

ERREURS de l'appareil

Consultez la liste complète des erreurs et exceptions.