스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

스마트 홈 습도 설정 특성 스키마

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

기기 속성

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

속성 유형 설명
humiditySetpointRange 객체

최소 및 최대 습도 수준이 백분율로 포함되어 있습니다.

minPercent 정수

(기본값: 0)

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

maxPercent 정수

(기본값: 100)

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

commandOnlyHumiditySetting Boolean

(기본값: false)

기기가 단방향 (true) 또는 양방향 (false) 통신을 사용하도록 지원하는지 나타냅니다. 기기가 이 특성에 관해 QUERY 인텐트 또는 보고서 상태에 응답할 수 없는 경우 이 속성을 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

기기 오류

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