Schéma de trait de modes de la maison connectée

action.devices.traits.Modes : cette caractéristique couvre tous les modes disponibles et les paramètres spécifiques à un mode pour un appareil.

Cette caractéristique appartient à tous les appareils dotés d'un nombre arbitraire de modes "n-way", dans lesquels les modes et les paramètres de chaque mode sont arbitraires et propres à chaque appareil ou type d'appareil. Chaque mode comporte plusieurs paramètres possibles, mais un seul peut être sélectionné à la fois. Un sèche-linge ne peut pas être en mode "Délicat", "Normal" et "Intensif" simultanément. Un paramètre qui peut simplement être activé ou désactivé appartient à la caractéristique Toggles.

Par exemple, une machine à laver peut avoir des paramètres pour la taille de la charge et la température. Il s'agit de deux modes, car ils sont indépendants l'un de l'autre, mais chacun ne peut être dans qu'un seul état à la fois. L'utilisateur peut définir explicitement un mode tel que la température à l'aide d'une commande telle que Définir la température du lave-linge sur "froide".

Certains modes sont "ordonnés" et peuvent également être ajustés avec des expressions comme "haut/bas", "augmenter/diminuer". Par exemple, la taille de la charge (petite, moyenne, grande) et la température sont clairement organisées (notez que la température n'est pas un thermostat réel avec une cible numérique, comme sur d'autres appareils), mais le type de charge (délicat, normal, laine, etc.) ne l'est pas forcément.

Cette caractéristique couvre un ou plusieurs modes individuels que les utilisateurs peuvent définir. En général, ces modes doivent être utilisés pour les fonctionnalités qui ne sont pas associées au comportement d'autres appareils. Le comportement associé, comme l'activation ou la désactivation de l'appareil lui-même, doit utiliser des traits plus spécifiques (par exemple, le thermostatMode dans le trait TemperatureSetting).

ATTRIBUTS de l'appareil

Les appareils dotés de 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
availableModes Array

Obligatoire.

Liste des modes disponibles.
[item, ...] Objet

Mode disponible.
name String

Obligatoire.

Nom interne du mode, qui sera utilisé dans les commandes et les états. Cela peut être peu pratique pour les utilisateurs et sera partagé dans toutes les langues.
name_values Array

Obligatoire.

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

Synonyme du mode dans une langue donnée.
name_synonym Array

Obligatoire.

Synonyme du mode. 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.
settings Array

Obligatoire.

Paramètres compatibles avec ce mode.
[item, ...] Objet

Paramètre compatible.

Vous devez ajouter au moins deux éléments.
setting_name String

Obligatoire.

Nom interne du paramètre de mode, qui sera utilisé dans les commandes et les états. Cela peut être peu pratique pour les utilisateurs et sera partagé dans toutes les langues.
setting_values Array

Obligatoire.

Synonyme du paramètre dans chaque langue prise en charge.
[item, ...] Objet

Synonyme du paramètre dans une langue donnée.
setting_synonym Array

Obligatoire.

Synonyme du paramètre. 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 Valeur booléenne

(Par défaut : false)

Si cette valeur est définie sur "true", une grammaire supplémentaire pour la logique d'augmentation/de diminution s'applique, dans l'ordre (croissant) du tableau des paramètres.
commandOnlyModes Valeur booléenne

(Par défaut : false)

Indique si l'appareil prend en charge la communication à sens unique (true) ou à double sens (false). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ou à un état de rapport pour cette caractéristique.
queryOnlyModes Valeur booléenne

(Par défaut : false)

Obligatoire si l'appareil est compatible avec l'exécution par requête uniquement. Cet attribut indique si l'appareil ne peut être interrogé que pour obtenir des informations sur son état et ne peut pas être contrôlé.

Exemples

Appareil avec plusieurs modes et paramètres

{
  "availableModes": [
    {
      "name": "load_mode",
      "name_values": [
        {
          "name_synonym": [
            "Load",
            "Size",
            "Load size"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "small_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Small",
                "Half"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "medium_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Medium",
                "Normal"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "large_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Large",
                "Full"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": true
    },
    {
      "name": "temp_mode",
      "name_values": [
        {
          "name_synonym": [
            "Temperature",
            "Temp"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "hot_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Hot",
                "White"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "warm_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Warm",
                "Color"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "cold_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Cold",
                "Delicate"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ]
}

Appareil avec des modes en mode commande uniquement.

{
  "availableModes": [
    {
      "name": "light_mode",
      "name_values": [
        {
          "name_synonym": [
            "Light",
            "Lighting"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "day_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Day",
                "Bright"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "night_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Night",
                "Dark"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "reading_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Reading",
                "Ambiant"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ],
  "commandOnlyModes": true,
  "queryOnlyModes": false
}

É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
currentModeSettings Objet

Obligatoire.

Paire clé/valeur avec le mode name de l'appareil comme clé et le setting_name actuel comme valeur.
<string> String

setting_name actuellement.

Exemples

Dans quel mode se trouve l'appareil ?

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

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

Modifiez les paramètres du mode.

Paramètres

Paramètres Type Description
updateModeSettings Objet

Obligatoire.

Paire clé-valeur avec le mode name de l'appareil comme clé et le nouveau setting_name comme valeur.
<string> String

Nouveau setting_name.

Exemples

Définir sur "charge importante".

{
  "command": "action.devices.commands.SetModes",
  "params": {
    "updateModeSettings": {
      "load_mode": "large_load"
    }
  }
}

Exemples d'énoncés

de-DE

  • Stelle den Staubsauger auf Ruhemodus

en-US

  • set the vacuum to energy saver mode

es-ES

  • pon la lavadora en modo frío

fr-FR

  • mets l'aspirateur en silencieux

hi-IN

  • वैक्यूम पर कार्पेट मोड लगाएं

it-IT

  • imposta l'aspirapolvere su silenzioso

ja-JP

  • 掃除機 を 静音 モードに設定して

ko-KR

  • 세탁기 세탁량 많음 으로 설정해

pt-BR

  • acionar a função autolimpeza do aspirador
  • ligar o modo de aquecimento

ERREURS de l'appareil

Consultez la liste complète des erreurs et exceptions.