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à del ventilatore (ovvero l'aria che esce dal dispositivo a vari livelli, che può far parte di un'unità di condizionamento o riscaldamento o di un'auto) possono includere impostazioni come bassa, media e alta o una percentuale.

ATTRIBUTI del dispositivo

I dispositivi con questo tratto possono 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

(Valore predefinito: false)

Se impostato su true, questo dispositivo supporta l'emissione di aria in entrambe le direzioni e può accettare il comando per invertire la direzione del ventilatore.
commandOnlyFanSpeed Valore booleano

(Valore 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 della velocità.
availableFanSpeeds Oggetto

Obbligatorio.

Impostazioni della velocità supportate dal dispositivo.
speeds Array

Obbligatorio.

Elenco delle impostazioni della velocità.
[item, ...] Oggetto

Impostazione della velocità.
speed_name String

Obbligatorio.

Nome interno dell'impostazione della velocità. Può non essere intuitivo per l'utente e verrà condiviso in tutte le lingue.
speed_values Array

Obbligatorio.

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

Sinonimo per l'impostazione della velocità in una determinata lingua. È necessario almeno un elemento con un valore lang di en per fornire il fallback della lingua.
speed_synonym Array

Obbligatorio.

Sinonimi per l'impostazione della velocità, devono includere le forme singolari e plurali, se applicabili. Il primo sinonimo nell'elenco verrà considerato il nome canonico dell'impostazione della velocità.
[item, ...] String

Sinonimo. È necessario almeno un elemento con un valore lang di en per fornire il fallback della lingua.
lang String

Obbligatorio.

Codice lingua (ISO 639-1). Controlla quali lingue sono 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 per la percentuale di velocità.
supportsFanSpeedPercent Valore booleano

Obbligatorio.

(Valore predefinito: false)

Se impostato su true, questo dispositivo accetterà i comandi per la regolazione della velocità utilizzando una percentuale da 0,0 a 100,0.

Esempi

Dispositivo con due impostazioni della velocità, supporto per la direzione inversa e regolazioni della percentuale.

{
  "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 della velocità corrente dall'attributo availableFanSpeeds.
currentFanSpeedPercent Numero

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

Il valore deve essere compreso tra 0 e 100.

Esempi

A che velocità sono i ventilatori in soggiorno?

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

COMANDI del dispositivo

I dispositivi con questo tratto possono 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à in base alle impostazioni.

Parametri Tipo Descrizione
fanSpeed String

Obbligatorio.

Le impostazioni della velocità richieste del ventilatore.

Imposta la velocità in percentuale.

Parametri Tipo Descrizione
fanSpeedPercent Numero

Obbligatorio.

La percentuale dell'impostazione della velocità richiesta.

Il valore deve essere compreso tra 0 e 100.

Esempi

Imposta il ventilatore su alta velocità.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeed": "speed_high"
  }
}

Imposta il ventilatore 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 la quantità relativa della variazione di velocità. Il valore assoluto indica la quantità scalata, mentre il segno numerico indica la direzione della variazione.

Il valore deve essere compreso tra -5 e 5.

Imposta la velocità relativa in percentuale.

Parametri Tipo Descrizione
fanSpeedRelativePercent Numero

Obbligatorio.

Questo valore rappresenta la percentuale di velocità da modificare.

Il valore deve essere compreso tra -100 e 100.

Esempi

Riduci leggermente la velocità del ventilatore.

{
  "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 del ventilatore.

Questo comando richiede i seguenti attributi: 
{
  "reversible": true
}

Parametri

Parametri Tipo Descrizione

Nessuna proprietà

Esempi

Inverti la direzione del ventilatore.

{
  "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 alla velocità minima.