Schema dei tratti di velocità del 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à delle ventole (ossia, soffiare aria dal dispositivo a vari livelli, che potrebbe far parte di un condizionatore o di un impianto di riscaldamento oppure di un'auto) possono includere impostazioni quali bassa, media, alta o percentuale.

ATTRIBUTES del dispositivo

I dispositivi con questo trait potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta fulfillment dell'intent.

Attributi Tipo Descrizione
reversible Booleano

(Valore predefinito: false)

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

commandOnlyFanSpeed Booleano

(Valore predefinito: false)

Indica se il dispositivo supporta l'uso di una comunicazione unidirezionale (true) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questo trait.

Contiene uno dei seguenti elementi:
0 Oggetto

Supporto per le impostazioni di velocità.

availableFanSpeeds Oggetto

Obbligatorio.

Impostazioni di velocità supportate dal dispositivo.

speeds Matrice

Obbligatorio.

Elenco delle impostazioni di velocità.

[item, ...] Oggetto

Impostazione della velocità.

speed_name String

Obbligatorio.

Nome interno dell'impostazione della velocità. Non è facile da usare e verrà condiviso in tutte le lingue.

speed_values Matrice

Obbligatorio.

Sinonimi dell'impostazione della velocità in ogni lingua supportata.

[item, ...] Oggetto

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

speed_synonym Matrice

Obbligatorio.

Sinonimi per l'impostazione della velocità, che devono includere sia il singolare che il plurale, se applicabile. Il primo sinonimo dell'elenco verrà considerato il nome canonico dell'impostazione di velocità.

[item, ...] String

Sinonimo.

lang String

Obbligatorio.

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

ordered Booleano

Obbligatorio.

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

1 Oggetto

Supporto della percentuale di velocità.

supportsFanSpeedPercent Booleano

Obbligatorio.

(Valore predefinito: false)

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

Esempi

Dispositivo con due impostazioni di velocità, supporto per le regolazioni in direzione inversa e 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
}

Dispositivo STATES

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

Stati Tipo Descrizione
currentFanSpeedSetting String

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

currentFanSpeedPercent Number

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

Esempi

Qual è la velocità dei ventilatori in salotto?

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

COMMANDS dispositivo

I dispositivi con questa caratteristica potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta fulfillment dell'intent.

action.devices.commands.SetFanSpeed

Imposta la velocità.

Parametri

Il payload contiene uno dei seguenti valori:

Scegli la velocità in base alle impostazioni.

Parametri Tipo Descrizione
fanSpeed String

Obbligatorio.

Le impostazioni di velocità della ventola richieste.

Imposta la velocità in percentuale.

Parametri Tipo Descrizione
fanSpeedPercent Number

Obbligatorio.

La percentuale di impostazione della velocità richiesta.

Esempi

Imposta la ventola al massimo.

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

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

Parametri Tipo Descrizione
fanSpeedRelativePercent Number

Obbligatorio.

Questo valore rappresenta la percentuale di velocità da modificare.

Esempi

Abbassa leggermente 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

Invertire la direzione della ventola.

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

Parametri

Parametri Tipo Descrizione

Nessuna proprietà

Esempi

Invertire la direzione della ventola.

{
  "command": "action.devices.commands.Reverse",
  "params": {}
}

Espressioni 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 medel

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