Schema tratto modalità Smart Home

action.devices.traits.Modes: questa caratteristica è valida per tutte le modalità e le impostazioni specifiche della modalità disponibili per un dispositivo.

Questo attributo appartiene a qualsiasi dispositivo con un numero arbitrario di modalità "n-way" in cui le modalità e le impostazioni di ogni modalità sono arbitrarie e univoche per ogni dispositivo o tipo di dispositivo. Ogni modalità ha più impostazioni possibili, ma è possibile selezionarne solo una alla volta. L'asciugatrice non può essere in modalità "delicata", "normale" e "ad alta intensità" contemporaneamente. Un'impostazione che può essere semplicemente attivata o disattivata appartiene alla sezione Attiva/disattiva.

Ad esempio, una lavatrice può avere impostazioni per la dimensione e la temperatura di carico. Entrambe sarebbero modalità perché sono indipendenti l'una dall'altra, ma ognuna può essere in un solo stato alla volta. L'utente può impostare una modalità come la temperatura in modo esplicito con un comando come Imposta la temperatura della lavatrice su freddo.

Alcune modalità sono "ordinate" e possono anche essere regolate con aumento/riduzione, aumento/riduzione della frase. Ad esempio, le dimensioni del carico (piccolo, medio, grande) e la temperatura sono ordinate in modo chiaro (tieni presente che la temperatura non è un termostato reale con target numerico, come su altri dispositivi), ma il tipo di carico (delicati, normali, lana e così via) potrebbe non esserlo.

Questa caratteristica copre una o più modalità individuali che gli utenti possono impostare. In generale, queste modalità dovrebbero essere utilizzate per la funzionalità che è scollegata dal comportamento di un altro dispositivo. Per quanto riguarda il comportamento collegato, ad esempio l'accensione o lo spegnimento del dispositivo, devi utilizzare caratteristiche più specifiche (ad es. la proprietà thermostatMode nella sezione TemperatureSetting).

ATTRIBUTE del dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Soddisfazione degli intent.

Attributi	Tipo	Descrizione
availableModes	Array	Obbligatorio. Elenco delle modalità disponibili.
[item, ...]	Oggetto	Modalità disponibile.
name	Stringa	Obbligatorio. Nome interno della modalità, che verrà utilizzato nei comandi e negli stati. Questa funzionalità non è facile da usare e verrà condivisa in tutte le lingue.
name_values	Array	Obbligatorio. Sinonimi della modalità in tutte le lingue supportate.
[item, ...]	Oggetto	Sinonimi della modalità in una determinata lingua.
name_synonym	Array	Obbligatorio. Sinonimi della modalità. La prima stringa dell'elenco viene utilizzata come nome canonico del livello in quella lingua.
[item, ...]	Stringa	Nome sinonimo.
lang	Stringa	Obbligatorio. Codice lingua (ISO 639-1). Scopri le lingue supportate.
settings	Array	Obbligatorio. Impostazioni supportate per questa modalità.
[item, ...]	Oggetto	Impostazione supportata. Richiede almeno due elementi.
setting_name	Stringa	Obbligatorio. Nome interno dell'impostazione della modalità, che verrà utilizzato nei comandi e negli stati. Questa funzionalità non è facile da usare e verrà condivisa in tutte le lingue.
setting_values	Array	Obbligatorio. Sinonimi dell'impostazione in tutte le lingue supportate.
[item, ...]	Oggetto	Sinonimi dell'impostazione in una determinata lingua.
setting_synonym	Array	Obbligatorio. Sinonimi dell'impostazione. La prima stringa dell'elenco viene utilizzata come nome canonico del livello in quella lingua.
[item, ...]	Stringa	Nome sinonimo.
lang	Stringa	Obbligatorio. Codice lingua (ISO 639-1). Scopri le lingue supportate.
ordered	Booleano	(Valore predefinito: false) Se è impostato su true, verrà applicata una grammatica aggiuntiva per la logica di aumento/diminuzione, nell'ordine (aumento) della matrice di impostazioni.
commandOnlyModes	Booleano	(Valore predefinito: false) Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (falso). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questa caratteristica.
queryOnlyModes	Booleano	(Valore predefinito: false) Obbligatorio se il dispositivo supporta l'esecuzione di sole query. Questo attributo indica se è possibile eseguire query su un dispositivo solo per avere informazioni sullo stato e non è possibile controllarlo.

Esempi

Dispositivo con più modalità e impostazioni.

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

Dispositivo con modalità di solo comando.

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

Le entità con questa caratteristica possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta Soddisfazione degli intent.

Stati	Tipo	Descrizione
currentModeSettings	Oggetto	Obbligatorio. Coppia chiave-valore con la modalità name del dispositivo come chiave e setting_name corrente come valore.
<string>	Stringa	Attuale: setting_name.

Esempi

In quale modalità si trova il dispositivo?

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

comandi del dispositivo

I dispositivi con questa caratteristica possono rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta Soddisfazione degli intent.

action.devices.commands.SetModes

Aggiorna le impostazioni della modalità.

Parametri

Parametri	Tipo	Descrizione
updateModeSettings	Oggetto	Obbligatorio. Coppia chiave/valore con la modalità name del dispositivo come chiave e la nuova setting_name come valore.
<string>	Stringa	Nuovo setting_name.

Esempi

Imposta il carico di grandi dimensioni.

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

Esempi di frasi

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

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.