스마트 홈 블라인드 가이드

action.devices.types.BLINDS - 블라인드를 열거나 닫을 수 있으며, 베네치안 (한 방향으로 열림), 패널 또는 수직 (왼쪽 또는 오른쪽으로 열림), 상하 (위쪽 또는 아래쪽으로 열림) 등 다양한 유형의 블라인드가 지원됩니다. 일부 블라인드에는 회전할 수 있는 슬랫이 있을 수 있습니다.

이 유형은 기기가 블라인드 아이콘과 일부 관련 동의어 및 별칭을 가져옴을 나타냅니다.

기기 기능

서비스에서 지원해야 하는 속성 및 상태, EXECUTE 및 QUERY 응답을 빌드하는 방법 등 구현 세부정보는 해당 특성 문서를 참고하세요.

필수 특성

이러한 특성과 명령어는 기기에 적용되는 경우 필요합니다. 기기에서 이러한 특성을 지원하지 않으면 쿼리 또는 실행 응답에 functionNotSupported 오류 코드를 입력합니다. 자세한 내용은 오류 및 예외를 참고하세요.

action.devices.traits.OpenClose

기기 예: 간단한 블라인드

이 섹션에는 위의 기기 유형과 특성을 기반으로 하는 일반적인 '블라인드'를 나타내는 인텐트 페이로드의 예가 포함되어 있습니다. 구현에서 특성을 추가하거나 삭제하는 경우 이러한 변경사항을 반영하도록 응답을 적절히 수정하세요.

위에서 아래로, 아래에서 위로 열리는 블라인드에서 UP 방향은 블라인드의 하단 부분을 올리고 DOWN 방향은 블라인드의 상단 부분을 내립니다. 그림 1은 UP 방향으로 블라인드의 하단 부분이 50% 올라가고 DOWN 방향으로 블라인드의 상단 부분이 30% 내려가는 상하 블라인드의 예를 보여줍니다.

샘플 SYNC 응답

요청

{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}

대답

{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.BLINDS",
        "traits": [
          "action.devices.traits.OpenClose"
        ],
        "name": {
          "name": "Simple blinds"
        },
        "willReportState": true,
        "attributes": {
          "openDirection": [
            "UP",
            "DOWN"
          ]
        },
        "deviceInfo": {
          "manufacturer": "smart-home-inc",
          "model": "hs1234",
          "hwVersion": "3.2",
          "swVersion": "11.4"
        }
      }
    ]
  }
}

샘플 QUERY 응답

요청

{
  "requestId": "6894439706274654514",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123"
          }
        ]
      }
    }
  ]
}

대답

{
  "requestId": "6894439706274654514",
  "payload": {
    "devices": {
      "123": {
        "status": "SUCCESS",
        "online": true,
        "openState": [
          {
            "openPercent": 30,
            "openDirection": "DOWN"
          },
          {
            "openPercent": 50,
            "openDirection": "UP"
          }
        ]
      }
    }
  }
}

샘플 실행 명령어

OpenClose

명령어 매개변수에 관한 자세한 내용은 action.devices.traits.OpenClose 참조를 확인하세요.

요청

{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.OpenClose",
                "params": {
                  "openPercent": 10,
                  "openDirection": "DOWN"
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

대답

{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "openState": [
            {
              "openPercent": 10,
              "openDirection": "DOWN"
            },
            {
              "openPercent": 50,
              "openDirection": "UP"
            }
          ]
        }
      }
    ]
  }
}

기기 오류

오류 및 예외의 전체 목록을 참고하세요.