Schema Trait della velocità della fan 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 soffiare aria dal dispositivo a vari livelli, che potrebbero far parte di un l'aria condizionata o il riscaldamento o in un'auto), possono includere impostazioni quali bassa, media e alta o una percentuale.

ATTRIBUTES dispositivo

I dispositivi con questo tratto potrebbero segnalare quanto segue nell'ambito dell'operazione SYNC. Per ulteriori informazioni scopri di più sulla gestione degli intent SYNC; consulta Completamento dell'intent.

Attributi Tipo Descrizione
reversible Valore booleano

(Valore predefinito: false)

Se viene impostato su true, il dispositivo supporta l'apertura 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 (vero) 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 velocità.
speed_name String

Obbligatorio.

Nome interno dell'impostazione della velocità. Questi dati non sono facili da usare e verranno condivisi in tutte le lingue.
speed_values Array

Obbligatorio.

Sinonimi dell'impostazione della velocità in tutte le lingue supportate.
[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 la forma singolare che quella plurale, se applicabile. 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). Vedi le lingue supportate.
ordered Valore booleano

Obbligatorio.

Se il valore è 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.

(Valore predefinito: false)

Se viene impostato su true, il dispositivo accetterà i comandi per la regolazione della velocità utilizzando una percentuale compresa tra 0,0 e 100,0.

Esempi

Dispositivo con due impostazioni di velocità, supporto per la retromarcia e 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 del dispositivo

Le entità con questo tratto possono segnalare quanto segue nell'ambito dell'operazione QUERY. Per ulteriori informazioni scopri di più sulla gestione degli intent QUERY; consulta Completamento dell'intent.

Stati Tipo Descrizione
currentFanSpeedSetting String

Rappresenta il nome interno dell'impostazione della velocità attuale dall'attributo availableFanSpeeds.
currentFanSpeedPercent Number

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

Esempi

A che velocità hanno le ventole in salotto?

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

COMANDI dispositivo

I dispositivi con questo tratto potrebbero rispondere ai seguenti nell'ambito dell'operazione EXECUTE. Per ulteriori informazioni scopri 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:

Scegli la velocità in base alle impostazioni.

Parametri Tipo Descrizione
fanSpeed String

Obbligatorio.

Le impostazioni della velocità richieste per la ventola.

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 modifica.

Imposta la velocità relativa in base alla percentuale.

Parametri Tipo Descrizione
fanSpeedRelativePercent Number

Obbligatorio.

Questo valore rappresenta la percentuale della velocità da modificare.

Esempi

Abbassa un po' 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 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 enunciato

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 dispositivo

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