스마트스위치

NUGU스마트홈에서 제공하는 기종 중 스마트스위치(SWITCH) 기종에 대한 정보입니다. 스마트스위치는 스위치를 통해 제어하는 최종 기기의 전원 제어 기능을 지원합니다. 스마트스위치는 스위치를 제어함으로써 실제로 타 유형의 스마트홈 기기를 최종적으로 제어할 수 있습니다. 이 때 다양한 명령어를 통한 기능을 제공하려면 최종제어하는 스마트홈 기기 유형으로 등록해주세요.

Discovery

NUGU스마트홈에 세탁기(WASHER)를 등록하고자 할 때 Discovery Request/Response의 예시입니다. 사용자가 NUGU 모바일 앱을 통해 IoT ServiceProvider의 계정을 연동한 후 스마트홈 기기를 등록하려고 시도할 때 NUGU스마트홈이 SmartHomeBackendProxy에 Discovery 요청을 보내고 이 때 등록할 수 있는 스마트홈 기기 정보를 응답해야 합니다. 스마트스위치는 스위치를 제어함으로써 실제로 타 유형의 스마트홈 기기를 최종적으로 제어할 수 있습니다. 이 때 다양한 명령어를 통한 기능을 제공하려면 최종제어하는 스마트홈 기기 유형으로 등록해주세요.

Discovery Request 예시

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

{
  "devices": [
    {
      "id": "1234567",
      "deviceTypeCode": "SWITCH",
      "deviceTypeName": "example_device_type",
      "deviceModelName": "example_model_name",
      "friendlyName": "멀티탭",
      "manufacturer": "example_manufacturer",
      "supportedCapabilities": {
        "powerControl": {
        }
      },
      "customData": {
        "foo": "bar"
      },
      "connectionStatus": true
    }
  ]
}

Recommended Capabilities

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

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