Smart Home attiva/disattiva lo schema tratto
action.devices.traits.Toggles
: questa caratteristica appartiene a qualsiasi dispositivo con impostazioni che possono esistere solo in uno dei due stati.
Queste impostazioni possono rappresentare un pulsante fisico con stato on/off oppure attivo/inattivo, una casella di controllo in HTML o qualsiasi altro tipo di elemento specificamente attivato/disattivato. Se l'impostazione ha più di due stati o ha uno stato in cui non è selezionata nessuna delle opzioni binarie, l'impostazione viene meglio rappresentata come una caratteristica di Modalità, che equivale a quadranti multi-stato, pulsanti di opzione (fisici o HTML) o stati binari non esplicitamente attivi/disattivati (ad esempio, "AM/FM" o "caldo/freddo").
Questo attributo copre uno o più pulsanti di attivazione/disattivazione individuali che gli utenti possono impostare. In generale, queste opzioni devono essere utilizzate per la funzionalità che non è collegata ad altri comportamenti dei dispositivi. I comportamenti collegati, ad esempio l'accensione o lo spegnimento del dispositivo stesso, devono usare caratteristiche più specifiche (ad es. 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 |
---|---|---|
availableToggles |
Array |
Obbligatorio. Elenco di opzioni di attivazione/disattivazione disponibili. |
[item, ...] |
Oggetto |
Pulsante di attivazione/disattivazione disponibile. |
name |
Stringa |
Obbligatorio. Nome interno dell'opzione, 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 dell'opzione in ciascuna lingua supportata. |
[item, ...] |
Oggetto |
Sinonimi dell'opzione in una data lingua. |
name_synonym |
Array |
Obbligatorio. Sinonimi dell'opzione di attivazione/disattivazione. 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. |
commandOnlyToggles |
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. |
queryOnlyToggles |
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ù pulsanti di attivazione/disattivazione.
{ "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 per i comandi.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "commandOnlyToggles": true }
Dispositivo con opzioni di attivazione/disattivazione solo per le query.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "queryOnlyToggles": true }
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 |
---|---|---|
currentToggleSettings |
Oggetto |
Obbligatorio. Coppia chiave/valore con l'opzione di attivazione/disattivazione |
<string> |
Booleano |
Stato di attivazione/disattivazione attuale. |
Esempi
La sterilizzazione è attiva?
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
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.SetToggles
Imposta un determinato stato di attivazione/disattivazione.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
updateToggleSettings |
Oggetto |
Obbligatorio. Coppia chiave/valore con l'opzione 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 } } }
Esempi di frasi
de-DE
-
Bitte schalte
Power Cool am Kühlschrank aus -
stelle
den Kühlschrank aufPower Cool
en-US
-
activate
power freeze forthe freezer -
cancel
power cool forthe kitchen fridge
es-ES
-
pon el
enfriamiento rápido enla nevera -
quita el
enfriamiento rápido
fr-FR
-
mets le mode
power cool surle réfrigérateur -
Éteins le mode
power freeze duré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 opde koelkast -
zet
de koelkast opsuperkoelen
pt-BR
-
Ativa a função
power freeze nocongelador . -
Desativa o
bloqueio infantil doforno . -
desligar o
power cool dageladeira -
iniciar o modo
power freeze dofreezer
sv-SE
-
Stäng av
power cool ikylskåpet -
sätt på
power freeze påfrysen