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 cechy inteligentnego wentylatora domu HomeSpeed

action.devices.traits.FanSpeed – ten atrybut należy do urządzeń, które obsługują ustawienie prędkości wentylatora.

Prędkości wentylatorów (tj. wentylator na różnych poziomach, które mogą być częścią systemu klimatyzacji lub ogrzewania albo w samochodzie), mogą zawierać ustawienia takie jak „niski”, średni, wysoki lub procentowy.

ATRYBUTY urządzenia

W ramach operacji SYNC urządzenia z tą cechą mogą zgłaszać wymienione poniżej atrybuty. Więcej informacji o obsłudze intencji SYNC znajdziesz w sekcji Realizacja intencji.

Atrybuty Typ Opis
reversible Wartość logiczna

(domyślnie: false)

Jeśli ma wartość Prawda, to urządzenie obsługuje wentylator w obu kierunkach i może przyjmować polecenia odwrócenia kierunku wentylatora.

commandOnlyFanSpeed Wartość logiczna

(domyślnie: false)

Wskazuje, czy urządzenie obsługuje komunikację jednokierunkową (prawda) czy 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

Wymagany.

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

speeds Tablica

Wymagany.

Lista ustawień prędkości.

[item, ...] Obiekt

Ustawienie szybkości.

speed_name Ciąg

Wymagany.

Wewnętrzna nazwa ustawienia szybkości. Może nie być odpowiedni dla użytkowników i będzie dostępny we wszystkich językach.

speed_values Tablica

Wymagany.

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

[item, ...] Obiekt

synonim ustawienia szybkości w danym języku.

speed_synonym Tablica

Wymagany.

Synonimy ustawienia szybkości powinny mieć formę liczby pojedynczej i mnogiej (w stosownych przypadkach). Pierwszy synonim na liście jest uznawany za kanoniczną nazwę ustawienia szybkości.

[item, ...] Ciąg

Synonim.

lang Ciąg

Wymagany.

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

ordered Wartość logiczna

Wymagany.

Jeśli ma wartość Prawda, stosowana jest dodatkowa gramatyka służąca do zwiększania i zmniejszania wartości w kolejności (zwiększanie) tablicy prędkości.

1 Obiekt

Obsługa procentowej szybkości.

supportsFanSpeedPercent Wartość logiczna

Wymagany.

(domyślnie: false)

Jeśli ma wartość Prawda, urządzenie akceptuje polecenia dotyczące zmiany prędkości na podstawie wartości procentowej od 0,0 do 100,0.

Przykłady

Urządzenie z 2 ustawieniami prędkości i obsługą cofania 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
}

Urządzenie STATES

W ramach operacji QUERY encje o tym atrybucie mogą raportować te stany. Więcej informacji o obsłudze intencji QUERY znajdziesz w sekcji Realizacja intencji.

Stany Typ Opis
currentFanSpeedSetting Ciąg

Jest to wewnętrzna nazwa bieżącego ustawienia szybkości z atrybutu availableFanSpeeds.

currentFanSpeedPercent Number

Wskazuje aktualną prędkość wentylatora według wartości procentowych. Wymagane, jeśli atrybut supportsFanSpeedPercent ma wartość true

Przykłady

Jak szybko są wentylatory w salonie?

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

Polecenie urządzenia

W ramach operacji EXECUTE urządzenia z tą cechą mogą odpowiadać na podane niżej polecenia. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w sekcji Realizacja intencji.

action.devices.commands.SetFanSpeed

Ustaw szybkość.

Parametry

Ładunek zawiera jeden z tych elementów:

Ustaw szybkość według ustawień.

Parametry Typ Opis
fanSpeed Ciąg

Wymagany.

Żądane ustawienia prędkości wentylatora.

Ustaw szybkość według wartości procentowych.

Parametry Typ Opis
fanSpeedPercent Number

Wymagany.

Żądany procent ustawienia szybkości.

Przykłady

Ustaw wentylator na wysokie.

{
  "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 jeden z tych elementów:

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

Parametry Typ Opis
fanSpeedRelativeWeight Liczba całkowita

Wymagany.

Ta wartość określa względną zmianę szybkości. Wartość bezwzględna wskazuje powiększoną kwotę, a znak numeryczny wskazuje kierunek zmiany.

Ustaw szybkość względną według wartości procentowych.

Parametry Typ Opis
fanSpeedRelativePercent Number

Wymagany.

Ta wartość to procent szybkości zmiany.

Przykłady

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

Urządzenie ERRORS

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