제습기

NUGU스마트홈에서 제공하는 기종 중 제습기(DEHUMIDIFICATION) 기종에 대한 정보입니다. 제습기는 동작을 위한 전원 제어 기능 및 목표 습도 설정 기능, 제습기의 풍량 제어 기능과 각 모델별로 지원하는 모드 설정 기능, 종료예약 설정 기능을 지원합니다.

Discovery

NUGU스마트홈에 제습기(DEHUMIDIFICATION)를 등록하고자 할 때 Discovery Request/Response의 예시입니다. 사용자가 NUGU 모바일 앱을 통해 IoT ServiceProvider의 계정을 연동한 후 스마트홈 기기를 등록하려고 시도할 때 NUGU스마트홈이 SmartHomeBackendProxy에 Discovery 요청을 보내고 이 때 등록할 수 있는 스마트홈 기기 정보를 응답해야 합니다.

Discovery Request 예시

(POST, /nugu/v1/devices)
복사성공!
1
2
3
{
  "token": "7KOdwPQdJPZf4KYsjtHdqz3e8fKd"
}

Discovery Response 예시

복사성공!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
{
  "devices": [
    {
      "id": "1234567",
      "deviceTypeCode": "DEHUMIDIFICATION",
      "deviceTypeName": "example_device_type",
      "deviceModelName": "example_model_name",
      "friendlyName": "부엌",
      "manufacturer": "example_manufacturer",
      "supportedCapabilities": {
        "airflowControl": {
          "supportedAirflowTypes": [
            "HIGH",
            "MIDDLE",
            "LOW",
            "SPEED1",
            "SPEED2",
            "SPEED3",
            "TURBO"
          ] // 지원 가능한 Airflow 타입 참고.
        },
        "setTimeControl": {},
        "modeControl": {
          "supportedModes": [
            "DEHUMIDITY",
            "COMFORT",
            "AIR_BLAST",
            "ENERGY_SAVING"
          ] // 지원 가능한 Mode 타입 참고.
        },
        "powerControl": {},
        "humidityControl": {
          "minHumidity": "30",
          "maxHumidity": "70",
          "humidityStep": "1"
        }
      },
      "customData": {
        "foo": "bar"
      },
      "connectionStatus": true
    }
  ]
}

NUGU스마트홈을 통해 제습기(DEHUMIDIFICATION)를 제어할 때 권장하는 SmartHome Capability 목록입니다. 권장하는 모든 Capability를 지원하지 않아도 되며 스마트홈 기기 자체 기능에 맞추어 제공하고자 하는 Capability 목록을 Discovery 시 응답에 포함해야 합니다.

Capability별 상세한 내용은 아래 리스트의 링크를 통해 확인하실 수 있습니다.

Capability Description 예시발화
PowerControl 제습기 전원 제어 기능입니다.
전원을 켜고 끄며 동작을 제어하는 기능들로 구성되어 있습니다.
“제습기 켜줘”
AirflowControl 제습기의 풍량 제어 기능입니다.
설정 풍량에 대한 상세한 정보는 SmartHomeAttribute : AirflowType을 참조하시기 바랍니다.
“제습기 풍량 강풍으로 설정해줘”
ModeControl 제습기의 모드 제어 기능입니다.
설정 모드에 대한 상세한 정보는 SmartHomeAttribute : Mode를 참조하시기 바랍니다.
“제습기 자동제습모드로 설정해줘”
SetTimeControl 제습기 기기의 시간 설정 기능입니다. “제습기 1시간 후로 종료예약해줘”
HumidityControl 제습기의 습도 제어 기능입니다.
주변 습도 및 희망 습도에 대한 기능들로 구성되어 있습니다.
“제습기 습도 50%로 설정해줘”