Schéma de Trait pour la maison connectée

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

Cette caractéristique appartient à tous les appareils avec un nombre arbitraire de modes "n-way", dans lesquels les modes et les paramètres de chaque mode sont arbitraires et uniques pour chaque appareil ou type d'appareil. Chaque mode offre plusieurs paramètres, mais il n'est possible de sélectionner qu'un seul sèche-linge à la fois. Un sèche-linge ne peut pas être à la fois en mode délicat, normal et intensive. Un paramètre qui peut simplement être activé ou désactivé appartient à la caractéristique Toggles.

Par exemple, une machine à laver peut configurer des réglages pour le volume de chargement et la température. Il s'agit dans les deux cas de modes, car ils sont indépendants l'un de l'autre, mais chacun ne peut se trouver que dans un seul état à la fois. L'utilisateur peut définir explicitement un mode comme la température à l'aide d'une commande telle que Définir la température du lave-linge sur froid.

Certains modes sont "classés" et peuvent également être ajustés à l'aide du texte à la hausse ou à la baisse, ou du texte augmenter/diminuer. Par exemple, la taille de charge (petite, moyenne, grande) et la température sont clairement ordonné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élicats, normal, laine, etc.) peut ne pas l'être.

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 des fonctionnalités dissociées des autres comportements de l'appareil. Les comportements associés, tels que l'allumage ou l'arrêt de l'appareil lui-même, doivent utiliser des caractéristiques plus spécifiques (par exemple, thermostatMode dans la caractéristique TemperatureSetting).

Attributs d'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. Elle peut être non conviviale et sera partagée dans toutes les langues.

name_values Array

Obligatoire.

Synonymes du mode dans chaque langue disponible.

[item, ...] Objet

Synonymes du mode dans une langue donnée.

name_synonym Array

Obligatoire.

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

Nécessite 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. Elle peut être non conviviale et sera partagée dans toutes les langues.

setting_values Array

Obligatoire.

Synonymes du paramètre dans chacune des langues disponibles.

[item, ...] Objet

Synonymes du paramètre dans une langue donnée.

setting_synonym Array

Obligatoire.

Synonymes 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 Booléen

(Par défaut : false)

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

commandOnlyModes Booléen

(Par défaut : false)

Indique si l'appareil est compatible avec la communication unidirectionnelle (vrai) ou bidirectionnelle (faux). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ni à un état de rapport pour cette caractéristique.

queryOnlyModes Booléen

(Par défaut : false)

Obligatoire si l'appareil permet l'exécution de requêtes uniquement. Cet attribut indique si l'appareil ne peut être interrogé que pour des informations d'état, et ne peut pas être contrôlé.

Exemples

Appareil avec modes et paramètres multiples.

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

Device 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 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 est l'appareil ?

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

COMMANDS d'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

Paramètres du mode de mise à jour.

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éfinissez une 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 sur l'appareil

Consultez la liste complète des erreurs et exceptions.