Schéma de Trait des modes de maison connectée

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

Cette caractéristique appartient à tous les appareils avec un nombre arbitraire de "n-way" modes dans lesquels le modes et paramètres de chaque mode sont arbitraires et uniques pour chaque appareil ou type d'appareil. Chaque mode est associé à plusieurs paramètres, mais vous ne pouvez en sélectionner qu'un à la fois. un sèche-linge ne peut pas être « délicats », « normal », et « robuste » simultanément. Un paramètre qui peuvent être activées ou désactivées dans la caractéristique Toggles.

Par exemple, une machine à laver peut définir des paramètres pour la taille de chargement et la température. Il s'agirait de modes, car ils sont indépendants l'un de l'autre, mais chacun ne peuvent avoir qu'un seul état à la fois. L'utilisateur peut définir un mode tel que explicitement à l'aide d'une commande telle que Régler la température du lave-linge sur à froid.

Certains modes sont "ordonnés" Vous pouvez aussi l'ajuster à l'aide des boutons haut/bas, augmenter/diminuer le vocabulaire. Par exemple, la taille du chargement (petite, moyenne, grande) et la température sont clairement ordonnées (notez que la température n'est pas thermostat avec une cible numérique, comme sur les autres appareils), mais le type de charge (objets délicats, normal, laine, etc.) peuvent ne pas l'être.

Cette caractéristique concerne 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 qui sont dissociées d'un autre appareil comportemental. Les comportements associés, comme allumer ou éteindre l'appareil lui-même, doivent utilisez des caractéristiques plus spécifiques (par exemple, le thermostatMode dans le caractéristique TemperatureSetting).

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
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. Cette approche peut ne pas être conviviale et sera utilisée dans toutes les langues.
name_values Array

Obligatoire.

Synonymes du mode dans chaque langue compatible.
[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

Synonyme du nom.
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.

Au moins deux articles sont requis.
setting_name String

Obligatoire.

Nom interne du paramètre de mode, qui sera utilisé dans les commandes et les états. Cette approche peut ne pas être conviviale et sera utilisée dans toutes les langues.
setting_values Array

Obligatoire.

Synonymes du paramètre dans chaque langue compatible.
[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

Synonyme du nom.
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 règle est définie sur "true", une grammaire supplémentaire pour la logique d'augmentation/diminution s'applique, dans l'ordre (croissant) du tableau de paramètres.
commandOnlyModes Valeur booléenne

(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 ou à l'état du rapport pour cette caractéristique.
queryOnlyModes Valeur booléenne

(Par défaut : false)

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

Exemples

Appareil avec mode 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 doté des 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
}

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

Obligatoire.

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

setting_name actuellement.

Exemples

Dans quel mode l'appareil est-il activé ?

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

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

Modifier 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

Nouvelle setting_name.

Exemples

Définissez la charge sur "Volume important".

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

Exemples d'énoncés

<ph type="x-smartling-placeholder">

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

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