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 inteligentnego określania wilgotności w domu

action.devices.traits.HumiditySetting – ten atrybut należy do urządzeń, które obsługują ustawienia wilgotności, w tym nawilżaczy i osuszaczy powietrza.

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

Zawiera minimalne i maksymalne poziomy wilgotności w procentach.

minPercent Liczba całkowita

(domyślnie: 0)

Określa minimalny poziom wilgotności w procentach.

maxPercent Liczba całkowita

(domyślnie: 100)

Określa maksymalny poziom wilgotności w procentach.

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

queryOnlyHumiditySetting Wartość logiczna

(domyślnie: false)

Wymagane, jeśli urządzenie obsługuje wykonywanie tylko zapytań. Ten atrybut wskazuje, że do urządzenia można wysyłać zapytania tylko o informacje o stanie i nie można nim sterować.

Przykłady

Urządzenie obsługujące domyślny zakres wilgotności.

{}

Urządzenie obsługujące niestandardowy zakres wilgotności.

{
  "humiditySetpointRange": {
    "minPercent": 25,
    "maxPercent": 75
  }
}

Urządzenie STATES

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

Stany Typ Opis
humiditySetpointPercent Liczba całkowita

Wskazuje bieżący docelowy procent wilgotności urządzenia. Musi mieścić się w zakresie humiditySetpointRange.

humidityAmbientPercent Liczba całkowita

Wskazuje bieżący poziom wilgotności otoczenia w procentach.

Przykłady

Jaka jest wilgotność na moim urządzeniu?

{
  "humiditySetpointPercent": 20,
  "humidityAmbientPercent": 15
}

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

Ustaw poziom wilgotności na wartość bezwzględną.

Parametry

Parametry Typ Opis
humidity Liczba całkowita

Wymagany.

Nastawa wilgotności procentowej. Musi mieścić się w zakresie humiditySetpointRange.

Przykłady

Ustaw wilgotność na 20 procent.

{
  "command": "action.devices.commands.SetHumidity",
  "params": {
    "humidity": 20
  }
}

Podczas ustawiania docelowej wilgotności wystąpił błąd.

Obsługiwane wartości:

maxSettingReached
minSettingReached
valueOutOfRange

action.devices.commands.HumidityRelative

Dostosuj poziom wilgotności w stosunku do bieżącej wartości.

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

Parametry

Ładunek zawiera jeden z tych elementów:

Ustaw procent wilgotności.

Parametry Typ Opis
humidityRelativePercent Liczba całkowita

Wymagany.

Wartość procentowa umożliwiająca dostosowanie poziomu wilgotności.

Ustaw wagę wilgotności.

Parametry Typ Opis
humidityRelativeWeight Liczba całkowita

Wymagany.

Wskazuje stopień niejednoznacznej wilgotności. Zmienia się od niewielkiej wartości („odrobina”) do dużej („duża”).

Przykłady

Zwiększ wilgotność o 10%

{
  "command": "action.devices.commands.HumidityRelative",
  "params": {
    "humidityRelativePercent": 10
  }
}

Znacznie zmniejsz wilgotność

{
  "command": "action.devices.commands.HumidityRelative",
  "params": {
    "humidityRelativeWeight": -5
  }
}

Podczas zmiany wilgotności wystąpił błąd.

Obsługiwane wartości:

maxSettingReached
minSettingReached
valueOutOfRange

Urządzenie ERRORS

Zobacz pełną listę błędów i wyjątków.