Schema del tratto FanSpeed per la smart home

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

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

ATTRIBUTI del dispositivo

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

Attributi Tipo Descrizione
reversible Valore booleano

(valore predefinito: false)

Se impostato su true, questo dispositivo supporta il soffio della ventola in entrambe le direzioni e può accettare il comando per invertire la direzione della ventola.
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 intento QUERY o a uno stato 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 delle impostazioni di velocità.
[item, ...] Oggetto

Impostazione della velocità.
speed_name String

Obbligatorio.

Nome interno dell'impostazione della velocità. Questo approccio può non essere intuitivo e verrà condiviso in tutte le lingue.
speed_values Array

Obbligatorio.

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

Sinonimo dell'impostazione della velocità in una determinata lingua.
speed_synonym Array

Obbligatorio.

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

Sinonimo.
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 speeds.
1 Oggetto

Supporto della percentuale di velocità.
supportsFanSpeedPercent Valore booleano

Obbligatorio.

(valore predefinito: false)

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

Esempi

Dispositivo con due impostazioni di velocità, supporto per la 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 scoprire di più sulla gestione degli intent QUERY, consulta Adempimento 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 del ventilatore in percentuale. Obbligatorio se l'attributo supportsFanSpeedPercent è impostato su true

Esempi

A quale velocità girano i ventilatori 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 Adempimento 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 di velocità richieste del ventilatore.

Imposta la velocità in percentuale.

Parametri Tipo Descrizione
fanSpeedPercent Number

Obbligatorio.

La percentuale di impostazione della velocità richiesta.

Esempi

Imposta il ventilatore su 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 velocità da modificare.

Esempi

Abbassa leggermente la velocità del ventilatore.

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

Aumenta la velocità del ventilatore del 10 percento.

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

action.devices.commands.Reverse

Invertire 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": {}
}

Frasi di esempio

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 sulla velocità massima.
  • minSpeedReached: il dispositivo è già impostato sulla velocità minima.