Schéma du Trait Smart Home

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

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
availableFillLevels	Objet	Décrit les différents niveaux de remplissage de l'appareil.
levels	Array	Obligatoire. Liste de noms de niveau et de synonymes spécifiques à la 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. Synonymes du niveau dans chaque langue compatible.
[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	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 la 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 "true", acceptez les commandes permettant d'ajuster le niveau à un pourcentage.

Exemples

Appareil doté de fonctionnalités de remplissage ou de drainage de base non compatibles avec les niveaux de remplissage distincts.

{}

Appareil compatible avec les niveaux de remplissage discrets.

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

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
isFilled	Valeur booléenne	Obligatoire. "True" si l'appareil est plein à n'importe quel niveau. "False" si l'appareil est complètement vidé.
currentFillLevel	String	Obligatoire si l'attribut availableFillLevels est défini. Indique la valeur level_name actuelle de l'attribut availableFillLevels lorsque l'appareil est rempli.
currentFillPercent	Number	Obligatoire si l'attribut supportsFillPercent est défini. Indique le pourcentage actuel du niveau de remplissage.

Exemples

La baignoire est-elle remplie ?

{
  "isFilled": true
}

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

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

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

Remplissez ou videz l'appareil.

Paramètres

Paramètres	Type	Description
fill	Valeur booléenne	Obligatoire. Vrai pour le remplissage, faux pour drainer.
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

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

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