Witamy w Google Home Developer Center – nowym miejscu, z którego dowiesz się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.
Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Schemat schematu inteligentnego prędkości wentylatora

action.devices.traits.FanSpeed – ten atrybut należy do urządzeń, które obsługują szybkość wentylatora.

Prędkości wentylatorów (tj. dmuchanie powietrza z urządzenia na różnych poziomach, które mogą być częścią klimatyzacji lub grzejnej albo w samochodzie), mogą być określone, np. jako niski, średni lub wysoki.

ATRYBUTY na urządzeniu

Urządzenia z tą cechą mogą zgłaszać w ramach operacji SYNC te atrybuty. Więcej informacji o obsłudze intencji SYNC znajdziesz w artykule Realizacja intencji.

Atrybuty Typ Opis
reversible Wartość logiczna

(Domyślnie: false)

Jeśli zasada ma wartość Prawda, urządzenie może dmuchać wentylator w obu kierunkach i przyjmuje polecenie odwrócenia wentylatora.

commandOnlyFanSpeed Wartość logiczna

(Domyślnie: false)

Wskazuje, czy urządzenie obsługuje komunikację jednokierunkową (prawda) lub dwukierunkową (fałsz). Ustaw ten atrybut na wartość „true”, jeśli urządzenie nie może odpowiedzieć na intencję QUERY lub stan raportu w przypadku tego atrybutu.

Zawiera dowolne z tych elementów:
0 Obiekt

Obsługa ustawień szybkości.

availableFanSpeeds Obiekt

Wymagane.

Ustawienia szybkości obsługiwane przez urządzenie.

speeds Tablica

Wymagane.

Lista ustawień prędkości.

[item, ...] Obiekt

Ustawienie szybkości.

speed_name Ciąg

Wymagane.

Wewnętrzna nazwa ustawienia prędkości. Może to być nieatrakcyjne i udostępniane we wszystkich językach.

speed_values Tablica

Wymagane.

Synonimy ustawienia szybkości w każdym obsługiwanym języku.

[item, ...] Obiekt

Synonim ustawienia szybkości w danym języku.

speed_synonym Tablica

Wymagane.

Synonimy ustawienia szybkości powinny mieć zarówno formę liczby pojedynczej, jak i mnogiej (w stosownych przypadkach). Pierwszy synonim na liście będzie uznawany za kanoniczną nazwę ustawienia szybkości.

[item, ...] Ciąg

Synonim.

lang Ciąg

Wymagane.

Kod języka (ISO 639-1). Zobacz obsługiwane języki.

ordered Wartość logiczna

Wymagane.

Jeśli ma wartość Prawda, stosowana jest dodatkowa gramatyka przyrostu lub zmniejszania wartości w kolejności (zwiększanie) tablicy szybkości.

1 Obiekt

Obsługa procentu szybkości.

supportsFanSpeedPercent Wartość logiczna

Wymagane.

(Domyślnie: false)

Jeśli zasada ma wartość Prawda, urządzenie przyjmuje polecenia dotyczące zmiany prędkości z zakresu od 0,0 do 100,0.

Przykłady

Urządzenie z 2 ustawieniami szybkości i obsługą odwrotnego kierunku ruchu i procentowej korekty.

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

STANY urządzenia

Urządzenia z tą cechą mogą w ramach operacji QUERY zgłaszać następujące stany. Więcej informacji o obsłudze intencji QUERY znajdziesz w artykule Realizacja intencji.

Stany Typ Opis
currentFanSpeedSetting Ciąg

Jest to wewnętrzna nazwa prędkości i atrybutu availableFanSpeeds.

currentFanSpeedPercent Number

Wskazuje aktualną szybkość wentylatora w procentach. Wymagany, jeśli atrybut supportsFanSpeedPercent ma wartość true

Przykłady

Jaka jest prędkość wentylatorów w salonie?

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

Polecenia dotyczące urządzenia

Urządzenia z tą cechą mogą w ramach operacji EXECUTE reagować na następujące polecenia. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w artykule Realizacja intencji.

action.devices.commands.SetFanSpeed

Ustaw prędkość.

Parametry

Ładunek zawiera jedną z tych wartości:

Ustaw szybkość według ustawień.

Parametry Typ Opis
fanSpeed Ciąg

Wymagane.

Żądane ustawienia szybkości wentylatora.

Ustaw szybkość o procentowo.

Parametry Typ Opis
fanSpeedPercent Number

Wymagane.

Żądany procent wartości szybkości.

Przykłady

Ustaw wentylator na wysoką wartość.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeed": "speed_high"
  }
}

Ustaw wentylator na 50%.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeedPercent": 50
  }
}

action.devices.commands.SetFanSpeedRelative

Ustaw szybkość względną.

To polecenie wymaga tych atrybutów:
{
  "commandOnlyFanSpeed": true
}

Parametry

Ładunek zawiera jedną z tych wartości:

Ustaw względną szybkość według wagi.

Parametry Typ Opis
fanSpeedRelativeWeight Liczba całkowita

Wymagane.

Ta wartość pokazuje względną zmianę szybkości. Wartość bezwzględna oznacza przeskalowaną kwotę, natomiast znak liczbowy wskazuje kierunek zmiany.

Ustaw szybkość względnej wartości procentowej.

Parametry Typ Opis
fanSpeedRelativePercent Number

Wymagane.

Ta wartość to procent zmiany prędkości.

Przykłady

Zmniejszaj prędkość wentylatora.

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

Zwiększ prędkość wentylatora o 10%.

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

action.devices.commands.Reverse

Odwróć kierunek wentylatora.

To polecenie wymaga tych atrybutów:
{
  "reversible": true
}

Parametry

Parametry Typ Opis

Brak właściwości

Przykłady

Odwróć kierunek wentylatora.

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

Przykładowe wypowiedzi

de-DE

  • stell die Geschwindigkeit Ventylator vom auf hoch

en-US

  • zmniejsz wentylację klimatyzatora wentylator do średniego

es-ES

  • Camcam la velocidad del ventilador a medio

fr-FR

  • spełnia przewietrznik la au maksymalną

Urządzenie ERRORS

Zobacz pełną listę błędów i wyjątków.
  • maxSpeedReached: urządzenie ma już ustawioną maksymalną prędkość.
  • minSpeedReached: urządzenie ma już ustawioną minimalną prędkość.