스마트 홈 HumiditySetting 특성 스키마

action.devices.traits.HumiditySetting - 이 특성은 가습기, 제습기와 같은 습도 설정을 지원하는 기기에 속합니다.

기기 속성

이 특성이 있는 기기는 SYNC 작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC 인텐트 처리에 대해 자세히 알아보려면 인텐트 처리를 참고하세요.

속성 유형 설명
humiditySetpointRange 객체

최소 및 최대 습도 수준을 백분율로 포함합니다.
minPercent 정수

(기본값: 0)

최소 습도 수준을 백분율로 나타냅니다.

값은 0에서 100 사이여야 합니다.
maxPercent 정수

(기본값: 100)

최대 습도 수준을 백분율로 나타냅니다.

값은 0에서 100 사이여야 합니다.
commandOnlyHumiditySetting Boolean

(기본값: false)

기기가 단방향 (true) 또는 양방향 (false) 통신을 지원하는지 나타냅니다. 기기가 이 특성의 QUERY 인텐트 또는 상태 보고에 응답할 수 없는 경우 이 속성을 true로 설정합니다.
queryOnlyHumiditySetting Boolean

(기본값: false)

기기에서 쿼리 전용 실행을 지원하는 경우 필수입니다. 이 속성은 기기의 상태 정보만 쿼리할 수 있고 제어할 수 없는지 여부를 나타냅니다.

예

기본 습도 범위를 지원하는 기기

{}

맞춤 습도 범위를 지원하는 기기

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

기기 상태

이 특성이 있는 항목은 QUERY 작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY 인텐트 처리에 대해 자세히 알아보려면 인텐트 처리를 참고하세요.

주 유형 설명
humiditySetpointPercent 정수

기기의 현재 목표 습도 비율을 나타냅니다. humiditySetpointRange 범위 내에 있어야 합니다.
humidityAmbientPercent 정수

기기의 현재 주변 습도를 백분율로 나타냅니다.

값은 1에서 100 사이여야 합니다.

예

내 기기에는 어떤 습도가 표시되나요?

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

기기 명령어

이 특성이 있는 기기는 EXECUTE 작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE 인텐트 처리에 대해 자세히 알아보려면 인텐트 처리를 참고하세요.

action.devices.commands.SetHumidity

습도 수준을 절대 값으로 설정합니다.

매개변수

매개변수 유형 설명
humidity 정수

필수사항.

습도 설정값 비율입니다. humiditySetpointRange 범위 내에 있어야 합니다.

예

습도를 20%로 설정해 줘.

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

목표 습도를 설정하는 중에 오류가 발생했습니다.

지원되는 값:

maxSettingReached
minSettingReached
valueOutOfRange

action.devices.commands.HumidityRelative

현재 값에 따라 습도 수준을 조정합니다.

이 명령어에는 다음 속성이 필요합니다. 
{
  "commandOnlyHumiditySetting": true
}

매개변수

페이로드에는 다음 중 하나가 포함됩니다.

습도 비율 설정

매개변수 유형 설명
humidityRelativePercent 정수

필수사항.

습도 수준을 조정할 백분율 값입니다.

값은 -100에서 100 사이여야 합니다.

습도 가중치를 설정합니다.

매개변수 유형 설명
humidityRelativeWeight 정수

필수사항.

소량 ('약간')에서 대량 ('많이')까지의 모호한 습도 변화량을 나타냅니다.

값은 -5에서 5 사이여야 합니다.

예

습도를 10% 높여 줘.

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

습도를 많이 낮춰 줘

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

습도를 조정하는 중에 오류가 발생했습니다.

지원되는 값:

maxSettingReached
minSettingReached
valueOutOfRange

샘플 발화

de-DE

  • Welche Luftfeuchtigkeit zeigt das Thermostat an?

en-US

  • what is the humidity upstairs

es-ES

  • cuánta humedad hay ahora en la cocina

fr-FR

  • le thermostat donne quel taux d'humidité

hi-IN

  • ह्यूमिडिटी का स्तर किचन के थर्मोस्टैट से कितना है?

it-IT

  • quanta umidità segna il termostato

ja-JP

  • サーモスタット にどれくらいの湿度ってでてる

ko-KR

  • 온도 조절계 에 습도 몇이야?

nl-NL

  • wat is de vochtigheid op de thermostaat

pt-BR

  • Qual é o nível de humidade mostrado no termostato ?
  • diga qual é a umidade relativa do ar mostrada no termostato

sv-SE

  • Vad är det för luftfuktighet i badrummet ?

기기 오류

오류 및 예외의 전체 목록을 참고하세요.