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인 경우 처리
airPurifierOperationMode가 POWER_OFF이면 디바이스 제어가 불가능합니다. 다음 예시와 같이 사용자에게 응답하도록 처리합니다.
- 응답 예시:
- "공기 청정기 전원이 꺼져있습니다."
POWER_ON인 경우 처리
airPurifierOperationMode가 POWER_ON이면 currentJobMode 값에 따라 다음과 같이 처리해주어야 합니다.
currentJobMode 혹은 windStrength가 AUTO인 경우
windStrength가 AUTO 이거나 혹은 currentJobMode가 AUTO인 경우 풍량이 자동으로 제어되며 수동으로 제어할 수 없습니다. 다음 예시와 같이 사용자에게 응답하도록 처리합니다.
- 응답 예시:
- "공기 청청기가 AUTO 모드로 동작 중이므로 제어할 수 없습니다."
currentJobMode와 windStrength 둘 다 AUTO가 아닌 경우
currentJobMode의 값이 AUTO가 아니고, windStrength 값도 AUTO가 아닌 경우 다음과 같이 처리합니다.
-
디바이스 프로파일을 조회하여 해당 공기 청정기 디바이스에서 지원하는 airFlow 값을 확인합니다. 제품 모델 별로 지원하는 airFlow 값이 다릅니다.
-
x-conditional-control를false로 변경합니다.{ "x-conditional-control": false, }
-
-
제어 요청 API 바디 값을 변경합니다.
-
{ "airFlow": { "windStrength": X } }
-
-
사용자에게 적절한 응답을 제공합니다.
- 응답예시
- 공기청정기 풍량을 power/high/mid/low 상태로 변경 하였습니다.
- 공기청정기 풍량이 최대/최소 상태입니다. (설정하고자 하는 풍량이 최대/최소 상태인 경우)
- 응답예시