Schema dei tratti delle modalità per la smart home

action.devices.traits.Modes: questa trait copre tutte le modalità disponibili e le impostazioni specifiche della modalità di un dispositivo.

Questo tratto appartiene a qualsiasi dispositivo con un numero arbitrario di "n-way" modalità in cui Le modalità e le impostazioni di ciascuna modalità sono arbitrarie e univoche per ciascun dispositivo o tipo di dispositivo. Ogni modalità ha più impostazioni possibili, ma è possibile selezionarne solo una alla volta. l'asciugatrice non può in "delicato" "normale", e "pesante" contemporaneamente. Un'impostazione che richiede semplicemente che può essere attivato o disattivato appartiene al trait Toggles.

Ad esempio, una lavatrice può avere impostazioni per dimensioni del carico e temperatura. Queste due modalità sono entrambe indipendenti, ma ognuna può essere in un solo stato alla volta. L'utente può impostare una modalità come la temperatura della lavatrice in modo esplicito con un comando come Imposta la temperatura della lavatrice su freddo.

Alcune modalità sono "ordinate" e può anche essere modificata con i pulsanti su/giù, aumentare/diminuire la fraseologia. Ad esempio, le dimensioni di caricamento (small, medium, large) e la temperatura sia ordinata in modo chiaro (tieni presente che la temperatura non è una termostato con un target numerico, come su altri dispositivi), ma il tipo di carico (delicati, normali, lana ecc.) potrebbero non esserlo.

Questa caratteristica riguarda una o più modalità individuali che l'utente può impostare. In generale, queste modalità devono essere usate per funzionalità scollegate da un altro dispositivo comportamento degli utenti. Il comportamento collegato, ad esempio l'accensione o lo spegnimento dello stesso, deve usano tratti più specifici (ad esempio, thermostatMode nel trait TemperatureSetting).

ATTRIBUTES dispositivo

I dispositivi con questo tratto potrebbero segnalare quanto segue nell'ambito dell'operazione SYNC. Per ulteriori informazioni scopri di più sulla gestione degli intent SYNC; consulta Completamento dell'intent.

Attributi	Tipo	Descrizione
availableModes	Array	Obbligatorio. Elenco delle modalità disponibili.
[item, ...]	Oggetto	Modalità disponibile.
name	String	Obbligatorio. Nome interno della modalità, che verrà utilizzato nei comandi e negli stati. Questi dati non sono facili da usare e verranno condivisi in tutte le lingue.
name_values	Array	Obbligatorio. Sinonimi della modalità in tutte le lingue supportate.
[item, ...]	Oggetto	Sinonimi della modalità in una data lingua.
name_synonym	Array	Obbligatorio. Sinonimi della modalità. La prima stringa di questo elenco viene utilizzata come nome canonico del livello nella lingua in questione.
[item, ...]	String	Nome sinonimo.
lang	String	Obbligatorio. Codice lingua (ISO 639-1). Vedi le lingue supportate.
settings	Array	Obbligatorio. Impostazioni supportate per questa modalità.
[item, ...]	Oggetto	Impostazione supportata. Sono necessari almeno 2 elementi.
setting_name	String	Obbligatorio. Nome interno dell'impostazione della modalità, che verrà utilizzato nei comandi e negli stati. Questi dati non sono facili da usare e verranno condivisi 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 di questo elenco viene utilizzata come nome canonico del livello nella lingua in questione.
[item, ...]	String	Nome sinonimo.
lang	String	Obbligatorio. Codice lingua (ISO 639-1). Vedi le lingue supportate.
ordered	Valore booleano	(Valore predefinito: false) Se questo valore è impostato su true, verrà applicata una grammatica aggiuntiva per la logica di aumento/diminuzione nell'ordine (crescente) dell'array delle impostazioni.
commandOnlyModes	Valore booleano	(Valore predefinito: false) Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a Segnalare lo stato per questo tratto.
queryOnlyModes	Valore booleano	(Valore predefinito: false) Obbligatorio se il dispositivo supporta l'esecuzione solo di query. Questo attributo indica se sul dispositivo è possibile eseguire query solo per informazioni sullo stato e se non può essere controllato.

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 del dispositivo

Le entità con questo tratto possono segnalare quanto segue nell'ambito dell'operazione QUERY. Per ulteriori informazioni scopri di più sulla gestione degli intent QUERY; consulta Completamento dell'intent.

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

Esempi

In quale modalità si trova il dispositivo?

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

COMANDI dispositivo

I dispositivi con questo tratto potrebbero rispondere ai seguenti nell'ambito dell'operazione EXECUTE. Per ulteriori informazioni scopri di più sulla gestione degli intent EXECUTE; consulta Completamento dell'intent.

action.devices.commands.SetModes

Impostazioni della modalità di aggiornamento.

Parametri

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

Esempi

Imposta un carico di grandi dimensioni.

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

Esempi di enunciato

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 dispositivo

Consulta l'elenco completo errori ed eccezioni.