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

action.devices.traits.HumiditySetting – ten atrybut należy do urządzeń, które obsługują ustawienia wilgotności, takie jak nawilżacze i nawilżacze.

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

Zawiera minimalny i maksymalny poziom wilgotności w procentach.

minPercent Liczba całkowita

(Domyślnie: 0)

Odzwierciedla 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) 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.

queryOnlyHumiditySetting Wartość logiczna

(Domyślnie: false)

Wymagane, jeśli urządzenie obsługuje wykonywanie tylko zapytań. Ten atrybut wskazuje, czy zapytania o urządzenie można wysyłać tylko w celu uzyskania informacji o stanie i których nie można kontrolować.

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

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
humiditySetpointPercent Liczba całkowita

Wskazuje aktualną wartość procentową wilgotności urządzenia. Wartość nie może przekraczać humiditySetpointRange.

humidityAmbientPercent Liczba całkowita

Wskazuje aktualnie wilgotność otoczenia w urządzeniu jako wartość procentową.

Przykłady

Jaka wilgotność jest wyświetlana na urządzeniu?

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

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

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

Parametry

Parametry Typ Opis
humidity Liczba całkowita

Wymagane.

Wartość procentowa wilgotności. Wartość nie może przekraczać 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 do bieżącej wartości.

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

Parametry

Ładunek zawiera jedną z tych wartości:

Ustaw procent wilgotności.

Parametry Typ Opis
humidityRelativePercent Liczba całkowita

Wymagane.

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

Ustaw wagę wilgotności.

Parametry Typ Opis
humidityRelativeWeight Liczba całkowita

Wymagane.

Wskazuje niejednoznaczną zmianę wilgotności: od małej ilości („mała”) do dużej („duża”).

Przykłady

Zwiększ wilgotność o 10 procent

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

Znacznie wilgotnie

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

Podczas dostosowywania 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.