Schema del tratto FanSpeed per la smart home

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

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.

ATTRIBUTES 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 funzionamento 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 l'utilizzo della comunicazione unidirezionale (true) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a Segnalare lo stato 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 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 dell'elenco sarà 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 retromarcia 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 attributo 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 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 Completamento dell'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 base alla 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 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 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 della 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 rotazione del ventilatore.

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