Air Purifier

디바이스 프로파일

지원하는 기능은 모델과 국가에 따라 다를 수 있습니다.

Property

Resource Property Value

Module Class

Type

Name

Type

R/W

Value

Description

airPurifierJobMode

(모드)

Object

currentJobMode

(운전모드)

Enum

RW

CLEAN

청정 모드

RW

SLEEP

취침 모드

RW

SILENT

정음, 저소음 모드

RW

HUMIDITY

가습 청정

RW

CIRCULATOR

순환 청정

RW

BABY_CARE

베이비 케어

RW

DUAL_CLEAN

듀얼 청정

RW

AUTO

오토 모드

RW

FAST

쾌속 모드

RW

SMART

스마트 모드

operation

(동작)

Object

airPurifierOperationMode

(본체 동작)

Enum

RW

POWER_ON

공기 청정기 가동 시작

RW

POWER_OFF

공기 청정기 가동 중지

timer

(타이머)

Object

absoluteHourToStart

Number

RW

 

지정한 켜짐 예약시각 - 시

absoluteMinuteToStart

Number

RW

 

지정한 켜짐 예약시각 - 분

absoluteHourToStop

Number

RW

 

지정한 꺼짐 예약시각 - 시

absoluteMinuteToStop

Number

RW

 

지정한 꺼짐 예약시각 - 분

airFlow

(바람 설정)

Object

windStrength

(바람세기)

Enum

RW

LOW

약풍

RW

MID

중풍

RW

HIGH

강풍

RW

POWER

파워

RW

AUTO

자동

airQualitySensor

(공기질)

Object

PM1

(PM1.0 극초미세먼지 농도, ㎍/㎥)

Number

R

76~

빨강 (매우나쁨)

R

36~75

노랑 (나쁨)

R

16~35

초록 (보통)

R

0~15

파랑 (좋음)

PM2

(PM2.5 초미세먼지 농도, ㎍/㎥)

Number

R

76~

빨강 (매우나쁨)

R

36~75

노랑 (나쁨)

R

16~35

초록 (보통)
R

0~15

파랑 (좋음)

PM10

(PM10 미세먼지 농도, ㎍/㎥)

Number

R

150~

빨강 (매우나쁨)

R

81~150

노랑 (나쁨)

R

31~80

초록 (보통)

R

0~30

파랑 (좋음)

oder

Number

R

 

냄새 농도 값

odor Number R   냄새 농도 값
odorLevel Enum R INVALID INVALID
R WEAK 약함
R NORMAL 보통
R STRONG 강함
R VERY_STRONG 매우 강함

humidity

Number

R

 

습도 값

totalPollution

(종합공기청정도)

Number

R

0

센서 전원이 꺼진 상태, 혹은 전원 켜진 후 초기화 중인 상태

R

1

좋음

R

2

보통

R

3

나쁨

R

4

매우 나쁨

totalPollutionLevel Enum R INVALID INVALID
R GOOD 좋음
R NORMAL 보통
R BAD 나쁨
R VERY_BAD 매우 나쁨

monitoringEnabled

(센서 모니터링 설정)

Enum

R

ON_WORKING

센서 모니터링 - 운전중만

R

ALWAYS

센서 모니터링 - 항상

Notification (Push Message)

Push Code Description

LACK_OF_WATER

물이 부족합니다. 

TIME_TO_CLEAN_FILTER

필터 청소가 필요합니다.

POLLUTION_IS_HIGH

오염도가 높습니다.

TIME_TO_CHANGE_FILTER

필터 교체 시기입니다.

JSON

{"notification": {"push": ["TIME_TO_CHANGE_FILTER",
                           "LACK_OF_WATER",
                           "POLLUTION_IS_HIGH",
                           "TIME_TO_CLEAN_FILTER"]},
 "property": {"airFlow": {"windStrength": {"mode": ["r", "w"],
                                           "type": "enum",
                                           "value": {"r": ["POWER",
                                                           "HIGH",
                                                           "MID",
                                                           "AUTO",
                                                           "LOW",
                                                           "SLOW"],
                                                     "w": ["POWER",
                                                           "HIGH",
                                                           "MID",
                                                           "AUTO",
                                                           "LOW",
                                                           "SLOW"]}}},
              "airPurifierJobMode": {"currentJobMode": {"mode": ["r", "w"],
                                                        "type": "enum",
                                                        "value": {"r": ["OFF",
                                                                        "ACO",
                                                                        "HUMIDITY",
                                                                        "DRY",
                                                                        "AI",
                                                                        "BABY_CARE",
                                                                        "CIRCULATOR",
                                                                        "AROMA",
                                                                        "ENERGY_SAVING",
                                                                        "SILENT",
                                                                        "SLEEP",
                                                                        "FAN",
                                                                        "AUTO",
                                                                        "DUAL_CLEAN",
                                                                        "HEAT",
                                                                        "AIRCLEAN",
                                                                        "COOL",
                                                                        "CLEAN"],
                                                                  "w": ["OFF",
                                                                        "ACO",
                                                                        "HUMIDITY",
                                                                        "DRY",
                                                                        "AI",
                                                                        "BABY_CARE",
                                                                        "CIRCULATOR",
                                                                        "AROMA",
                                                                        "ENERGY_SAVING",
                                                                        "SILENT",
                                                                        "SLEEP",
                                                                        "FAN",
                                                                        "AUTO",
                                                                        "DUAL_CLEAN",
                                                                        "HEAT",
                                                                        "AIRCLEAN",
                                                                        "COOL",
                                                                        "CLEAN"]}}},
              "airQualitySensor": {"PM1": {"mode": ["r"], "type": "number"},
                                   "PM10": {"mode": ["r"], "type": "number"},
                                   "PM2": {"mode": ["r"], "type": "number"},
                                   "humidity": {"mode": ["r"],
                                                "type": "number"},
                                   "monitoringEnabled": {"mode": ["r", "w"],
                                                         "type": "enum",
                                                         "value": {"r": ["ON_WORKING",
                                                                         "ALWAYS"],
                                                                   "w": ["ON_WORKING",
                                                                         "ALWAYS"]}},
                                   "oder": {"mode": ["r"], "type": "number"}},
              "operation": {"airPurifierOperationMode": {"mode": ["r", "w"],
                                                         "type": "enum",
                                                         "value": {"r": ["POWER_ON",
                                                                         "POWER_OFF"],
                                                                   "w": ["POWER_ON",
                                                                         "POWER_OFF"]}}},
              "timer": {"absoluteHourToStart": {"mode": ["r", "w"],
                                                "type": "number"},
                        "absoluteHourToStop": {"mode": ["r", "w"],
                                               "type": "number"},
                        "absoluteMinuteToStart": {"mode": ["r", "w"],
                                                  "type": "number"},
                        "absoluteMinuteToStop": {"mode": ["r", "w"],
                                                 "type": "number"}}}}

 

상태 조회 결과

Example

#Air Purifier
{
	"airPurifierJobMode": {
		"currentJobMode": "DUAL_CLEAN"
	},
	"operation": {
		"airPurifierOperationMode": "POWER_ON"
	},
	"timer": {
		"absoluteHourToStart": 9,
		"absoluteMinuteToStart": 20,
		"absoluteHourToStop": 22,
		"absoluteMinuteToStop": 40
	},
	"airFlow": {
		"windStrength": "AUTO"
	},
	"airQualitySensor": {
		"PM1": 8,
		"PM2": 9,
		"PM10": 10,
		"oder": 1,
		"humidity": 30,
		"monitoringEnabled": "ON_WORKING"
	}
}

 

제어 명령

Example

Air purifier power on

{ 
  "operation": {"airPurifierOperationMode": "POWER_ON"}
}

Air purifier wind strength adjustment 

{ 
  "airFlow": {"windStrength": "HIGH"}
}

Air purifier on timer (Timer set on 11: 30)

{
  "timer": {"absoluteHourToStart": 11, "absoluteMinuteToStart": 30}
}

Disables the timer: -1

{
  "timer": {"absoluteHourToStart": -1, "absoluteMinuteToStart": -1}
}

 

예외 처리 (풍량 제어)

디바이스 상태에 따라 디바이스를 제어할 수 없는 경우가 있습니다. 제어 요청 API를 사용할 경우, 먼저 디바이스 상태를 조회하고 제어가 불가능한 경우에 대해 적절한 예외 처리를 해주어야 합니다. 다음 예시를 참고하십시오. 

예) 사용자 명령: "공기 청정기 풍량 올려줘/내려줘." 

POWER_OFF인 경우 처리

airPurifierOperationModePOWER_OFF이면 디바이스 제어가 불가능합니다. 다음 예시와 같이 사용자에게 응답하도록 처리합니다. 

  • 응답 예시:
    • "공기 청정기 전원이 꺼져있습니다."

POWER_ON인 경우 처리

airPurifierOperationModePOWER_ON이면  currentJobMode 값에 따라 다음과 같이 처리해주어야 합니다.

currentJobMode 혹은 windStrength가 AUTO인 경우

windStrength가 AUTO 이거나 혹은 currentJobMode가 AUTO인 경우 풍량이 자동으로 제어되며 수동으로 제어할 수 없습니다. 다음 예시와 같이 사용자에게 응답하도록 처리합니다.

  • 응답 예시: 
    • "공기 청청기가 AUTO 모드로 동작 중이므로 제어할 수 없습니다."

currentJobMode와 windStrength 둘 다 AUTO가 아닌 경우

currentJobMode의 값이 AUTO가 아니고, windStrength 값도 AUTO가 아닌 경우 다음과 같이 처리합니다.

  1. 디바이스 프로파일을 조회하여 해당 공기 청정기 디바이스에서 지원하는 airFlow 값을 확인합니다.  제품 모델 별로 지원하는 airFlow 값이 다릅니다.

    • x-conditional-controlfalse로 변경합니다.

      {
        "x-conditional-control": false,
      }	
  2. 제어 요청 API 바디 값을 변경합니다.

    •      {
              "airFlow": {
                  "windStrength": X
               }  
           }
      
  3. 사용자에게 적절한 응답을 제공합니다.

    • 응답예시
      • 공기청정기 풍량을 power/high/mid/low 상태로 변경 하였습니다.
      • 공기청정기 풍량이 최대/최소 상태입니다. (설정하고자 하는 풍량이 최대/최소 상태인 경우)