La smart home attiva/disattiva lo schema dei tratti
action.devices.traits.Toggles
: questo trait appartiene a tutti i dispositivi le cui impostazioni possono esistere soltanto in uno di due stati.
Queste impostazioni possono rappresentare un pulsante fisico con uno stato on/off o attivo/inattivo, una casella di controllo in HTML o qualsiasi altro tipo di elemento specificatamente attivato/disattivato. Se l'impostazione ha più di due stati o ha uno stato in cui nessuna delle opzioni binarie è selezionata, è meglio rappresentata come un trait Modes, che equivale a quadranti multistato, pulsanti di opzione (fisici o HTML) o stati binari non esplicitamente attivati/disattivati (ad esempio, "AM/FM" o "caldo/freddo").
Questa trait riguarda uno o più comandi di attivazione/disattivazione individuali che gli utenti possono impostare. In
generale, questi pulsanti di attivazione/disattivazione devono essere utilizzati 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 |
---|---|---|
availableToggles |
Matrice |
Obbligatorio. Elenco dei pulsanti di attivazione/disattivazione disponibili. |
[item, ...] |
Oggetto |
Pulsante di attivazione/disattivazione Disponibile. |
name |
String |
Obbligatorio. Nome interno dell'opzione di attivazione/disattivazione, che verrà utilizzato nei comandi e negli stati. Non è facile da usare e verrà condiviso in tutte le lingue. |
name_values |
Matrice |
Obbligatorio. Sinonimi del pulsante di attivazione/disattivazione nelle lingue supportate. |
[item, ...] |
Oggetto |
Sinonimi del pulsante di attivazione/disattivazione in una determinata lingua. |
name_synonym |
Matrice |
Obbligatorio. Sinonimi del pulsante di attivazione/disattivazione. 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. |
commandOnlyToggles |
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. |
queryOnlyToggles |
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 attivazione/disattivazione multipla.
{ "availableToggles": [ { "name": "sterilization_toggle", "name_values": [ { "name_synonym": [ "Clean", "Bio clean" ], "lang": "en" } ] }, { "name": "energysaving_toggle", "name_values": [ { "name_synonym": [ "Energy saving", "Eco" ], "lang": "en" } ] } ] }
Dispositivo con opzioni di attivazione/disattivazione solo comando.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "commandOnlyToggles": true }
Dispositivo con opzioni di attivazione/disattivazione solo per query.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "queryOnlyToggles": true }
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 |
---|---|---|
currentToggleSettings |
Oggetto |
Obbligatorio. Coppia chiave/valore con il pulsante di attivazione/disattivazione |
<string> |
Booleano |
Stato di attivazione/disattivazione attuale. |
Esempi
La sterilizzazione è attiva?
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
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.SetToggles
Imposta un determinato stato di attivazione/disattivazione.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
updateToggleSettings |
Oggetto |
Obbligatorio. Coppia chiave/valore con il pulsante di attivazione/disattivazione |
<string> |
Booleano |
Nuovo stato di attivazione/disattivazione |
Esempi
Attiva il risparmio energetico.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "energysaving_toggle": true } } }
Disattiva il filtro.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "filter_toggle": false } } }
Espressioni di esempio
de-DE
- Bitte schalte Power Cool am Kühlschrank aus
- stelle den Kühlschrank auf Power Cool
en-US
- activate power freeze for the freezer
- cancel power cool for the kitchen fridge
es-ES
- pon el enfriamiento rápido en la nevera
- quita el enfriamiento rápido
fr-FR
- mets le mode power cool sur le réfrigérateur
- Éteins le mode power freeze du réfrigérateur .
hi-IN
- रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
- रेफ़्रिजरेटर में पावर कूल मोड चालू करो
it-IT
- disattiva il power freeze del freezer
- imposta la funzione power freeze del surgelatore
ja-JP
- 冷蔵庫 の 急速冷凍 つけて
- 冷蔵庫 の 急速冷凍 を切ってくれる
ko-KR
- 냉장고 급속 냉장 해제해
- 냉장고 모드 급속 냉장 으로 바꿔
nl-NL
- Zet de power cool uit op de koelkast
- zet de koelkast op superkoelen
pt-BR
- Ativa a função power freeze no congelador .
- Desativa o bloqueio infantil do forno .
- desligar o power cool da geladeira
- iniciar o modo power freeze do freezer
sv-SE
- Stäng av power cool i kylskåpet
- sätt på power freeze på frysen