복사성공!
1
2
3
{
"token": "7KOdwPQdJPZf4KYsjtHdqz3e8fKd"
}
NUGU스마트홈에서 제공하는 기종 중 에어컨(AIR_CONDITIONER) 기종에 대한 정보입니다. 에어컨은 냉방 온도 조절 장치로 전원 제어 기능 및 목표 온도 설정 기능, 에어컨의 풍량 제어 기능, 각 모델별로 지원하는 모드 설정 기능, 종료예약 설정 기능, 에어컨에서 측정한 주변 공기상태 조회 기능을 지원합니다.
Discovery
NUGU스마트홈에 에어컨(AIR_CONDITIONER)을 등록하고자 할 때 Discovery Request/Response의 예시입니다. 사용자가 NUGU 모바일 앱을 통해 IoT ServiceProvider의 계정을 연동한 후 스마트홈 기기를 등록하려고 시도할 때 NUGU스마트홈이 SmartHomeBackendProxy에 Discovery 요청을 보내고 이 때 등록할 수 있는 스마트홈 기기 정보를 응답해야 합니다.
Discovery Request 예시
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
45
{
"devices": [
{
"id": "1234567",
"deviceTypeCode": "AIR_CONDITIONER",
"deviceTypeName": "example_device_type",
"deviceModelName": "example_model_name",
"friendlyName": "거실",
"manufacturer": "example_manufacturer",
"supportedCapabilities": {
"airflowControl": {
"supportedAirflowTypes": [
"HIGH",
"MIDDLE",
"LOW",
"SPEED1",
"SPEED2",
"SPEED3",
"AUTO"
]
},
"airQualityCheck": {},
"setTimeControl": {},
"modeControl": {
"supportedModes": [
"DEHUMIDITY",
"COMFORT",
"AIR_BLAST",
"ENERGY_SAVING"
] // 지원 가능한 Mode 타입 참고.
},
"powerControl": {},
"temperatureControl": {
"minTemperature": "19",
"maxTemperature": "36",
"temperatureStep": "1"
}
},
"customData": {
"foo": "bar"
},
"connectionStatus": true
}
]
}
Recommended Capabilities
NUGU스마트홈을 통해 에어컨(AIR_CONDITIONER)을 제어할 때 권장하는 SmartHome Capability 목록입니다. 권장하는 모든 Capability를 지원하지 않아도 되며 스마트홈 기기 자체 기능에 맞추어 제공하고자 하는 Capability 목록을 Discovery 시 응답에 포함해야 합니다.
Capability별 상세한 내용은 아래 리스트의 링크를 통해 확인하실 수 있습니다.
| Capability | Description | 예시발 |
|---|---|---|
| PowerControl | 에어컨 전원 제어 기능입니다. 전원을 켜고 끄며 동작을 제어하는 기능들로 구성되어 있습니다. |
“에어컨 켜줘” |
| TemperatureControl | 에어컨의 설정 온도 제어 기능입니다. 기기 자체의 온도가 아닌 주변 온도 및 희망 온도에 대한 기능들로 구성되어 있습니다. |
“에어컨 온도 23도로 설정해줘” |
| AirflowControl | 에어컨의 풍량 제어 기능입니다. 설정 풍량에 대한 상세한 정보는 SmartHomeAttribute : AirflowType을 참조하시기 바랍니다. |
“에어컨 풍량 강풍으로 설정해줘” |
| ModeControl | 에어컨의 모드 제어 기능입니다. 설정 모드에 대한 상세헌 정보는 SmartHomeAttribute : Mode를 참조하시기 바랍니다. |
“에어컨 냉방모드로 설정해줘” |
| SetTimeControl | 에어컨 기기의 시간 설정 기능입니다. | “에어컨 1시간 후로 종료예약해줘” |
| AirQualityControl | 에어컨의 공기상태 조회 기능입니다. | “에어컨에서 공기상태 조회해줘” |