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: 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: 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: 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à |
<string> |
String |
Attuale: |
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à |
<string> |
String |
Nuovo |
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