Schema delle caratteristiche della smart home

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

Questa caratteristica appartiene a tutti i dispositivi con un numero arbitrario di modalità "n-way" in cui le modalità e le impostazioni per ogni modalità sono arbitrarie e univoche per ogni dispositivo o tipo di dispositivo. Ogni modalità ha diverse impostazioni possibili, ma è possibile selezionarne solo una alla volta; un'asciugatrice non può essere in modalità "delicata", "normale" e "heavy duty" contemporaneamente. Un'impostazione che può essere semplicemente attivata o disattivata appartiene al trait Toggles.

Ad esempio, una lavatrice può avere impostazioni per le dimensioni del carico e la temperatura. Si tratterebbe di entrambe le modalità perché sono indipendenti l'una dall'altra, ma ognuna può trovarsi in un solo stato alla volta. L'utente può impostare esplicitamente una modalità come la temperatura con un comando come Imposta la temperatura della lavatrice su freddo.

Alcune modalità sono "ordinate" e possono anche essere regolate con l'azione su/giù o aumentando/diminuendo la frase. Ad esempio, le dimensioni del carico (picco, medio, grande) e la temperatura sono ordinate in modo chiaro (tieni presente che la temperatura non è un vero termostato con un valore target numerico, come su altri dispositivi), mentre il tipo di carico (delicati, normale, lana e così via) potrebbe non esserlo.

Questa caratteristica riguarda una o più modalità individuali che gli utenti possono impostare. In generale, dovrebbero essere utilizzate queste modalità per la funzionalità che è scollegata da un altro comportamento del dispositivo. Il comportamento collegato, ad esempio l'accensione o lo spegnimento del dispositivo, dovrebbe usare tratti più specifici (ad esempio, thermostatMode nel trait TemperatureSetting).

ATTRIBUTES del dispositivo

I dispositivi con questo trait potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta fulfillment dell'intent.

Attributi Tipo Descrizione
availableModes Matrice

Obbligatorio.

Elenco delle modalità disponibili.

[item, ...] Oggetto

Modalità disponibile.

name String

Obbligatorio.

Nome interno della modalità, che verrà utilizzato nei comandi e negli stati. Non è facile da usare e verrà condiviso in tutte le lingue.

name_values Matrice

Obbligatorio.

Sinonimi della modalità in tutte le lingue supportate.

[item, ...] Oggetto

Sinonimi della modalità in una determinata lingua.

name_synonym Matrice

Obbligatorio.

Sinonimi della modalità. La prima stringa di questo elenco viene utilizzata come nome canonico del livello in quella lingua.

[item, ...] String

Nome del sinonimo.

lang String

Obbligatorio.

Codice lingua (ISO 639-1). Consulta le lingue supportate.

settings Matrice

Obbligatorio.

Impostazioni supportate per questa modalità.

[item, ...] Oggetto

Impostazione supportata.

Richiede almeno 2 elementi.

setting_name String

Obbligatorio.

Nome interno dell'impostazione della modalità, che verrà utilizzato nei comandi e negli stati. Non è facile da usare e verrà condiviso in tutte le lingue.

setting_values Matrice

Obbligatorio.

Sinonimi dell'impostazione in tutte le lingue supportate.

[item, ...] Oggetto

Sinonimi dell'impostazione in una determinata lingua.

setting_synonym Matrice

Obbligatorio.

Sinonimi dell'impostazione. La prima stringa di questo elenco viene utilizzata come nome canonico del livello in quella lingua.

[item, ...] String

Nome del sinonimo.

lang String

Obbligatorio.

Codice lingua (ISO 639-1). Consulta le lingue supportate.

ordered Booleano

(Valore predefinito: false)

Se il valore è impostato su true, viene applicata la grammatica aggiuntiva per la logica di aumento/diminuzione, nell'ordine (crescente) dell'array di impostazioni.

commandOnlyModes Booleano

(Valore predefinito: false)

Indica se il dispositivo supporta l'uso di una comunicazione unidirezionale (true) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questo trait.

queryOnlyModes Booleano

(Valore predefinito: false)

Obbligatorio se il dispositivo supporta l'esecuzione solo di query. Questo attributo indica se è possibile eseguire query sul dispositivo solo per informazioni sullo stato e se 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à 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
}

Dispositivo STATES

Le entità con questo trait possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta fulfillment dell'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> String

Attuale: setting_name.

Esempi

In quale modalità si trova il dispositivo?

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

COMMANDS dispositivo

I dispositivi con questa caratteristica potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta fulfillment 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

Impostato per un carico di grandi dimensioni.

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

Espressioni di esempio

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

ERRORS dispositivo

Consulta l'elenco completo di errori ed eccezioni.