Ti diamo il benvenuto nel Centro sviluppatori Google Home, la nuova destinazione per imparare a sviluppare azioni per la smart home. Nota:continuerai a creare azioni nella Console Actions.
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Schema trattino FanSpeed per la smart home

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

La velocità della ventola (ovvero la soffiazione di aria all'interno del dispositivo a vari livelli, che potrebbe far parte di un impianto di aria condizionata o riscaldamento o di un'auto), può includere impostazioni quali bassa, media e alta o percentuale.

ATTRIBUTE del dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Soddisfazione degli intent.

Attributi Tipo Descrizione
reversible Booleano

(Valore predefinito: false)

Se è impostata su true, questo dispositivo supporta la ventilazione in entrambe le direzioni e può accettare il comando per invertire la direzione.

commandOnlyFanSpeed Booleano

(Valore predefinito: false)

Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (falso). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del 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 di impostazioni di velocità.

[item, ...] Oggetto

Impostazione Velocità.

speed_name Stringa

Obbligatorio.

Nome interno dell'impostazione della velocità. Questa funzionalità non è facile da usare e verrà condivisa in tutte le lingue.

speed_values Array

Obbligatorio.

Sinonimi per l'impostazione della velocità in tutte le lingue supportate.

[item, ...] Oggetto

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

speed_synonym Array

Obbligatorio.

I sinonimi dell'impostazione di velocità devono includere forme al singolare e al plurale, se applicabili. Il primo sinonimo dell'elenco verrà considerato il nome canonico dell'impostazione di velocità.

[item, ...] Stringa

Sinonimo.

lang Stringa

Obbligatorio.

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

ordered Booleano

Obbligatorio.

Se impostato su true, verranno applicate regole di grammatica aggiuntive per l'aumento o la diminuzione nell'ordine (aumento) della matrice di velocità.

1 Oggetto

Supporto per la percentuale di velocità.

supportsFanSpeedPercent Booleano

Obbligatorio.

(Valore predefinito: false)

Se è impostato su true, questo dispositivo accetta i comandi per regolare la velocità utilizzando una percentuale compresa tra 0,0 e 100,0.

Esempi

Dispositivo con due impostazioni di velocità; supporto per la direzione inversa e le 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 dispositivo

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

Stati Tipo Descrizione
currentFanSpeedSetting Stringa

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

currentFanSpeedPercent Number

Indica la velocità corrente della ventola in percentuale. Obbligatorio se l'attributo supportsFanSpeedPercent è impostato su true

Esempi

A quale velocità sono i fan 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 Soddisfazione degli intent.

action.devices.commands.SetFanSpeed

Imposta la velocità.

Parametri

Il payload contiene uno dei seguenti valori:

Imposta la velocità in base alle impostazioni.

Parametri Tipo Descrizione
fanSpeed Stringa

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

Inverti direzione 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 frasi

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

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.
  • maxSpeedReached: il dispositivo è già impostato sulla velocità massima.
  • minSpeedReached: il dispositivo è già impostato sulla velocità minima.