Schema del tratto FanSpeed di Smart Home

action.devices.traits.FanSpeed: questo tratto appartiene ai dispositivi che supportano l'impostazione della velocità di un ventilatore.

Le velocità della ventola (ovvero l'aria che esce dal dispositivo a vari livelli, che può far parte di un impianto di climatizzazione o riscaldamento o di un'auto) possono includere impostazioni come bassa, media e alta o una percentuale.

ATTRIBUTI dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per saperne di più sulla gestione degli intent SYNC, consulta Completamento degli intent.

Attributi Tipo Descrizione
reversible Valore booleano

(Predefinito: false)

Se è impostato su true, questo dispositivo supporta la ventola in entrambe le direzioni e può accettare il comando per invertire la direzione della ventola.
commandOnlyFanSpeed Valore booleano

(Predefinito: false)

Indica se il dispositivo supporta la comunicazione unidirezionale (true) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a Report State per questo tratto.
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 delle impostazioni di velocità.
[item, ...] Oggetto

Impostazione della velocità.
speed_name String

Obbligatorio.

Nome interno dell'impostazione della velocità. Questo può essere difficile da leggere e verrà condiviso in tutte le lingue.
speed_values Array

Obbligatorio.

Sinonimi dell'impostazione della velocità in ogni lingua supportata.
[item, ...] Oggetto

Sinonimo dell'impostazione della velocità in una determinata lingua. Per fornire il fallback della lingua, è necessario almeno un elemento con un valore lang di en.
speed_synonym Array

Obbligatorio.

I sinonimi dell'impostazione della velocità devono includere sia la forma singolare che quella plurale, se applicabile. Il primo sinonimo nell'elenco verrà considerato il nome canonico dell'impostazione della velocità.
[item, ...] String

Sinonimo. Per fornire il fallback della lingua, è necessario almeno un elemento con un valore lang di en.
lang String

Obbligatorio.

Codice lingua (ISO 639-1). Consulta le lingue supportate.
ordered Valore booleano

Obbligatorio.

Se impostato su true, verrà applicata una grammatica aggiuntiva per la logica di aumento o diminuzione, nell'ordine (crescente) dell'array delle velocità.
1 Oggetto

Supporto della percentuale di velocità.
supportsFanSpeedPercent Valore booleano

Obbligatorio.

(Predefinito: false)

Se impostato su true, questo dispositivo accetterà i comandi per regolare la velocità utilizzando una percentuale compresa tra 0,0 e 100,0.

Esempi

Dispositivo con due impostazioni di velocità, supporto della direzione inversa e aggiustamenti 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
}

STATI del dispositivo

Le entità con questo tratto possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per saperne di più sulla gestione degli intent QUERY, consulta Completamento degli intent.

Stati Tipo Descrizione
currentFanSpeedSetting String

Rappresenta il nome interno dell'impostazione di velocità corrente dell'attributo availableFanSpeeds.
currentFanSpeedPercent Number

Indica la velocità attuale della ventola in percentuale. Obbligatorio se l'attributo supportsFanSpeedPercent è impostato su true

Esempi

A che velocità vanno le ventole del soggiorno?

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}

COMANDI del dispositivo

I dispositivi con questo tratto potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per saperne di più sulla gestione degli intent EXECUTE, consulta Completamento degli intent.

action.devices.commands.SetFanSpeed

Imposta la velocità.

Parametri

Il payload contiene uno dei seguenti elementi:

Imposta la velocità tramite le impostazioni.

Parametri Tipo Descrizione
fanSpeed String

Obbligatorio.

Le impostazioni di velocità richieste della ventola.

Imposta la velocità in percentuale.

Parametri Tipo Descrizione
fanSpeedPercent Number

Obbligatorio.

La percentuale di impostazione della velocità richiesta.

Esempi

Imposta la ventola su High (Alto).

{
  "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 elementi:

Imposta la velocità relativa in base al peso.

Parametri Tipo Descrizione
fanSpeedRelativeWeight Intero

Obbligatorio.

Questo valore indica l'entità relativa della variazione di velocità. Il valore assoluto indica l'importo scalato, mentre il segno numerico indica la direzione della variazione.

Imposta la velocità relativa in percentuale.

Parametri Tipo Descrizione
fanSpeedRelativePercent Number

Obbligatorio.

Questo valore rappresenta la percentuale di variazione della velocità.

Esempi

Riduci leggermente la velocità della ventola.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativeWeight": -1
  }
}

Aumenta la velocità del ventilatore del 10%.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativePercent": 10
  }
}

action.devices.commands.Reverse

Inverti la direzione della 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 espressioni

de-DE

  • stell die Geschwindigkeit vom Ventilator auf hoch

en-US

  • drop the AC fan speed to medium

es-ES

  • cambia la velocidad del ventilador a medio

fr-FR

  • mets la ventilation au maximum

hi-IN

  • बेडरूम में पंखे की गति मीडियम करें

it-IT

  • metti il condizionatore in salotto a velocità media

ja-JP

  • エアコン の風量を 高速 にセット

ko-KR

  • 선풍기 강풍 으로 틀어 줘

nl-NL

  • zet de snelheid van de ventilator op medium

pt-BR

  • definir a velocidade do ventilador para baixa
  • põe a ventoinha no máximo

sv-SE

  • Ställ in fläkten på medel

ERRORI del dispositivo

Consulta l'elenco completo di errori ed eccezioni.
  • maxSpeedReached: il dispositivo è già impostato alla velocità massima.
  • minSpeedReached: il dispositivo è già impostato sulla velocità minima.