스마트 홈 HumiditySetting 트레잇 스키마

action.devices.traits.HumiditySetting - 이 트레잇은 가습기 및 제습기와 같이 습도 설정을 지원하는 기기에 속합니다.

기기 속성

이 트레잇이 있는 기기는 SYNC 작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

속성 유형 설명
humiditySetpointRange 객체

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

(기본값: 0)

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

(기본값: 100)

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

(기본값: false)

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

(기본값: false)

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

예

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

{}

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

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

기기 상태

이 트레잇이 있는 항목은 QUERY 작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

주 유형 설명
humiditySetpointPercent 정수

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

기기의 현재 대기 습도 측정값을 백분율로 나타냅니다.

예

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

{
  "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 정수

필수사항.

습도 수준을 조정하는 비율 값입니다.

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

매개변수 유형 설명
humidityRelativeWeight 정수

필수사항.

불명확한 습도 변화의 양을 소량 ('약간')에서 대량 ('많음')으로 나타냅니다.

예

습도 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 ?

기기 오류

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