스마트플러그

NUGU스마트홈에서 제공하는 기종 중 스마트플러그(PLUG) 기종에 대한 정보입니다. 스마트플러그는 플러그의 전원 제어 기능, 플러그를 통한 전력사용량 조회 기능, 종료예약 설정 기능을 지원합니다.

Discovery

NUGU스마트홈에 스마트플러그(PLUG)를 등록하고자 할 때 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
{
  "devices": [
    {
      "id": "1234567",
      "deviceTypeCode": "PLUG",
      "deviceTypeName": "example_device_type",
      "deviceModelName": "example_model_name",
      "friendlyName": "내방",
      "manufacturer": "example_manufacturer",
      "supportedCapabilities": {
        "setTimeControl": {},
        "powerControl": {},
        "powerCheck": {}
      },
      "customData": {
        "foo": "bar"
      },
      "connectionStatus": true
    }
  ]
}

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

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

Capability Description 예시발화
PowerControl 스마트플러그 전원 제어 기능입니다.
전원을 켜고 끄며 동작을 제어하는 기능들로 구성되어 있습니다.
“스마트플러그 켜줘”
PowerCheck 스마트플러그 전력사용량 관련 조회 기능입니다. “스마트플러그 전력사용량 알려줘”
SetTimeControl 스마트플러그 기기의 시간 설정 기능입니다. “스마트플러그 1시간 후로 종료예약해줘”