Schema trattino FanSpeed per la smart home
action.devices.traits.FanSpeed
: questa caratteristica appartiene ai dispositivi che supportano l'impostazione della velocità di una ventola.
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 |
---|---|---|
reversible |
Booleano |
(Valore predefinito: Se è impostata su true, questo dispositivo supporta la ventilazione in entrambe le direzioni e può accettare il comando per invertire la direzione. |
commandOnlyFanSpeed |
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. |
Contiene uno dei seguenti elementi: | ||
0
|
Oggetto |
Supporto per le impostazioni di velocità. |
availableFanSpeeds |
Oggetto |
Obbligatorio. Impostazioni di velocità supportate dal dispositivo. |
speeds |
Array |
Obbligatorio. Elenco di impostazioni di velocità. |
[item, ...] |
Oggetto |
Impostazione Velocità. |
speed_name |
Stringa |
Obbligatorio. Nome interno dell'impostazione della velocità. Questa funzionalità non è facile da usare e verrà condivisa in tutte le lingue. |
speed_values |
Array |
Obbligatorio. Sinonimi per l'impostazione della velocità in tutte le lingue supportate. |
[item, ...] |
Oggetto |
Sinonimo dell'impostazione di velocità in una determinata lingua. |
speed_synonym |
Array |
Obbligatorio. I sinonimi dell'impostazione di velocità devono includere forme al singolare e al plurale, se applicabili. Il primo sinonimo dell'elenco verrà considerato il nome canonico dell'impostazione di velocità. |
[item, ...] |
Stringa |
Sinonimo. |
lang |
Stringa |
Obbligatorio. Codice lingua (ISO 639-1). Scopri le lingue supportate. |
ordered |
Booleano |
Obbligatorio. Se impostato su true, verranno applicate regole di grammatica aggiuntive per l'aumento o la diminuzione nell'ordine (aumento) della matrice di velocità. |
1
|
Oggetto |
Supporto per la percentuale di velocità. |
supportsFanSpeedPercent |
Booleano |
Obbligatorio. (Valore predefinito: Se è impostato su true, questo dispositivo accetta i comandi per regolare la velocità utilizzando una percentuale compresa tra 0,0 e 100,0. |
Esempi
Dispositivo con due impostazioni di velocità; supporto per la direzione inversa e le regolazioni percentuali.
{ "availableFanSpeeds": { "speeds": [ { "speed_name": "speed_low", "speed_values": [ { "speed_synonym": [ "Low", "Slow" ], "lang": "en" } ] }, { "speed_name": "speed_high", "speed_values": [ { "speed_synonym": [ "High", "Fast" ], "lang": "en" } ] } ], "ordered": true }, "reversible": true, "supportsFanSpeedPercent": 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 |
---|---|---|
currentFanSpeedSetting |
Stringa |
Rappresenta il nome interno dell'impostazione della velocità attuale dell'attributo |
currentFanSpeedPercent |
Number |
Indica la velocità corrente della ventola in percentuale. Obbligatorio se l'attributo |
Esempi
A quale velocità sono i fan in salotto?
{ "currentFanSpeedSetting": "speed_low", "currentFanSpeedPercent": 10 }
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.SetFanSpeed
Imposta la velocità.
Parametri
Il payload contiene uno dei seguenti valori:
Imposta la velocità in base alle impostazioni.
Parametri | Tipo | Descrizione |
---|---|---|
fanSpeed |
Stringa |
Obbligatorio. Le impostazioni di velocità della ventola richieste. |
Imposta la velocità in percentuale.
Parametri | Tipo | Descrizione |
---|---|---|
fanSpeedPercent |
Number |
Obbligatorio. La percentuale di impostazione della velocità richiesta. |
Esempi
Imposta la ventola su alta.
{ "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeed": "speed_high" } }
Imposta la ventola al 50%.
{ "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeedPercent": 50 } }
action.devices.commands.SetFanSpeedRelative
Imposta la velocità relativa.
Questo comando richiede i seguenti attributi:{ "commandOnlyFanSpeed": true }
Parametri
Il payload contiene uno dei seguenti valori:
Imposta la velocità relativa in base al peso.
Parametri | Tipo | Descrizione |
---|---|---|
fanSpeedRelativeWeight |
Intero |
Obbligatorio. Questo valore indica la quantità relativa della variazione di velocità. Il valore assoluto indica l'importo scalato, mentre il segno numerico indica la direzione della modifica. |
Imposta la velocità relativa in percentuale.
Parametri | Tipo | Descrizione |
---|---|---|
fanSpeedRelativePercent |
Number |
Obbligatorio. Questo valore rappresenta la percentuale di velocità da modificare. |
Esempi
Abbassa leggermente la velocità della ventola.
{ "command": "action.devices.commands.SetFanSpeedRelative", "params": { "fanSpeedRelativeWeight": -1 } }
Aumenta la velocità della ventola del 10%.
{ "command": "action.devices.commands.SetFanSpeedRelative", "params": { "fanSpeedRelativePercent": 10 } }
action.devices.commands.Reverse
Inverti direzione ventola.
Questo comando richiede i seguenti attributi:{ "reversible": true }
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
Nessuna proprietà |
Esempi
Inverti la direzione della ventola.
{ "command": "action.devices.commands.Reverse", "params": {} }
Esempi di frasi
de-DE
-
stell die Geschwindigkeit
vom Ventilator aufhoch
en-US
-
drop
the AC fan speed tomedium
es-ES
-
cambia la velocidad del
ventilador amedio
fr-FR
-
mets
la ventilation aumaximum
hi-IN
-
बेडरूम में पंखे
की गति
मीडियम करें
it-IT
-
metti
il condizionatore in salotto a velocitàmedia
ja-JP
-
エアコン の風量を高速 にセット
ko-KR
-
선풍기 강풍 으로 틀어 줘
nl-NL
-
zet de snelheid van
de ventilator opmedium
pt-BR
-
definir a velocidade do
ventilador parabaixa -
põe
a ventoinha nomáximo
sv-SE
-
Ställ in
fläkten påmedel
ERRORI del dispositivo
Consulta l'elenco completo degli errori e delle eccezioni.maxSpeedReached
: il dispositivo è già impostato sulla velocità massima.minSpeedReached
: il dispositivo è già impostato sulla velocità minima.