Bienvenue dans le Centre des développeurs Google Home, la nouvelle destination pour apprendre à développer des actions pour la maison connectée. Remarque : Vous continuerez à créer des actions dans la console Actions.
Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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

action.devices.traits.Modes : cette caractéristique couvre tous les modes disponibles et les paramètres spécifiques au mode d'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 uniques à chaque appareil ou type d'appareil. Chaque mode a plusieurs paramètres possibles, mais vous ne pouvez en sélectionner qu'un à la fois. Un sèche-linge ne peut pas être simultanément en mode "Delicate", "Normal" et "heavy duty". Un paramètre qui peut simplement être activé ou désactivé appartient à la caractéristique Toggles.

Par exemple, un lave-linge peut être configuré pour la taille de la charge et la température. Ces deux modes sont indépendants, car ils sont indépendants, mais ne peuvent être que dans un seul état à la fois. L'utilisateur peut définir explicitement un mode tel que la température avec une commande telle que Régler la température du lave-linge sur froid.

Certains modes sont "classés" et peuvent également être ajustés à l'aide de flèches vers le haut ou vers le bas. Par exemple, la taille de la charge (petite, moyenne, grande) et la température sont clairement classées (notez que la température n'est pas un thermostat réel avec une valeur numérique cible, comme sur les autres appareils), mais ce n'est pas toujours le cas (type de charge (détail, normal, laine, etc.).

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 qui sont dissociées du comportement d'un autre appareil. Les comportements associés, comme l'allumage ou l'arrêt de l'appareil lui-même, doivent utiliser des caractéristiques plus spécifiques (par exemple, thermostatMode dans le attribut TempératureSetting).

ATTRIBUTS

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 page Traitement des intents.

Attributs Type Description
availableModes Array

Obligatoire.

Liste des modes disponibles.

[item, ...] Objet

Mode disponible.

name Chaîne

Obligatoire.

Nom interne du mode, qui sera utilisé dans les commandes et les états. Cette fonctionnalité n'est pas facile à utiliser et sera partagée dans toutes les langues.

name_values Array

Obligatoire.

Synonymes du mode dans chaque langue acceptée.

[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, ...] Chaîne

Nom du synonyme.

lang Chaîne

Obligatoire.

Code de langue (ISO 639-1). Consultez les langues acceptées.

settings Array

Obligatoire.

Paramètres compatibles avec ce mode.

[item, ...] Objet

Paramètre compatible.

Nécessite au moins deux articles.

setting_name Chaîne

Obligatoire.

Nom interne du paramètre de mode, qui sera utilisé dans les commandes et les états. Cette fonctionnalité n'est pas facile à utiliser et sera partagée dans toutes les langues.

setting_values Array

Obligatoire.

Synonymes du paramètre dans chaque langue acceptée.

[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, ...] Chaîne

Nom du synonyme.

lang Chaîne

Obligatoire.

Code de langue (ISO 639-1). Consultez les langues acceptées.

ordered Booléen

(Par défaut : false)

Si cette règle est définie sur "true", des règles de grammaire supplémentaires s'appliquent pour l'augmentation et la diminution, dans l'ordre (en augmentant) du tableau de paramètres.

commandOnlyModes Booléen

(Par défaut : false)

Indique si l'appareil accepte la communication unidirectionnelle (vraie) ou bidirectionnelle (fausse). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ni à Report State pour cette caractéristique.

queryOnlyModes Booléen

(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 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 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
}

État : STATUSS

Les appareils présentant 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 page 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> Chaîne

setting_name actuellement.

Exemples

Dans quel mode se trouve l'appareil ?

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

Appareil COMMANDS

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 page Traitement des intents.

action.devices.commands.SetModes

Paramètres du mode de mise à jour.

Paramètres

Paramètres Type Description
updateModeSettings Objet

Obligatoire.

Une paire clé/valeur avec le mode name de l'appareil comme clé et le nouveau setting_name comme valeur.

<string> Chaîne

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

  • den Stausauger

en-US

  • définir le mode aspirateur sur économiseur d'énergie

es-ES

  • pon lavadora frío

fr-FR

  • l'aspirateur en silencieux

Appareil : ERRORS

Consultez la liste complète des erreurs et exceptions.