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: 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: 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: 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à |
<string> |
Stringa |
Attuale: |
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à |
<string> |
Stringa |
Nuovo |
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 aufRuhemodus
en-US
-
set
the vacuum toenergy saver mode
es-ES
-
pon
la lavadora en modofrío
fr-FR
-
mets
l'aspirateur ensilencieux
hi-IN
-
वैक्यूम परकार्पेट मोड लगाएं
it-IT
-
imposta
l'aspirapolvere susilenzioso
ja-JP
-
掃除機 を静音 モードに設定して
ko-KR
-
세탁기 세탁량 많음 으로 설정해
pt-BR
-
acionar a função
autolimpeza doaspirador -
ligar o modo de
aquecimento