스마트 홈 채우기 특성 스키마

action.devices.traits.Fill: 이 특성은 욕조와 같이 채우기를 지원하는 기기에 적용됩니다.

기기 속성

이 특성이 있는 기기는 SYNC 작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

속성 유형 설명
availableFillLevels 객체

기기를 채우는 다양한 수준을 설명합니다.

levels 배열

필수.

등급 이름 및 언어별 동의어 목록입니다.

[item, ...] 객체

등급 이름 및 언어별 동의어

level_name String

필수.

등급의 내부 이름입니다. 이 정책은 사용자 친화적이지 않을 수 있으며 모든 언어로 공유됩니다.

level_values 배열

필수.

지원되는 각 언어별 등급의 동의어입니다.

[item, ...] 객체

지정된 언어 수준의 레벨 동의어입니다.

level_synonym 배열

필수.

수준의 동의어입니다. 이 목록의 첫 번째 문자열은 해당 언어 수준의 표준 이름으로 사용됩니다.

[item, ...] String

동의어 이름입니다.

lang String

필수.

언어 코드 (ISO 639-1). 지원되는 언어를 확인하세요.

ordered Boolean

필수.

true인 경우 기기는 levels 배열 (예: 절반 수준)로 표시되는 증가 또는 감소 로직에 관한 문법을 추가로 처리합니다.

supportsFillPercent Boolean

(기본값: false)

true인 경우 수준을 백분율로 조정하는 명령어를 허용합니다.

예시

불연속 채우기 수준을 지원하지 않는 기본 채우기 또는 드레이닝 기능이 있는 기기

{}

불연속적인 채우기 수준을 지원하는 기기.

{
  "availableFillLevels": {
    "levels": [
      {
        "level_name": "half_level",
        "level_values": [
          {
            "level_synonym": [
              "Half",
              "Half way",
              "One half"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "level_name": "full_level",
        "level_values": [
          {
            "level_synonym": [
              "Full",
              "All the way",
              "Complete"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  }
}

기기 상태: STATES

이 특성이 있는 항목은 QUERY 작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

상태 유형 설명
isFilled Boolean

필수.

기기가 모든 수준으로 채워지면 참입니다. 기기가 완전히 드레이닝되면 false입니다.

currentFillLevel String

availableFillLevels 속성이 설정된 경우 필수 항목입니다. 기기가 채워진 availableFillLevels 속성의 현재 level_name를 나타냅니다.

currentFillPercent Number

supportsFillPercent 속성이 설정된 경우 필수 항목입니다. 현재 채우기 수준 비율을 나타냅니다.

예시

욕조가 채워져 있나요?

{
  "isFilled": true
}

욕조가 채워져 있나요? (등급 포함).

{
  "isFilled": true,
  "currentFillLevel": "half_level"
}

기기 COMMANDS

이 특성이 있는 기기는 EXECUTE 작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

action.devices.commands.Fill

기기를 채우거나 소모합니다.

매개변수

매개변수 유형 설명
fill Boolean

필수.

true로 채우고 배출하려면 false로 설정합니다.

fillLevel String

설정할 availableFillLevels 속성의 level_name를 나타냅니다. 지정하지 않으면 기본 수준을 입력합니다.

fillPercent Number

요청된 등급 비율을 나타냅니다.

예시

욕조를 채웁니다.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true
  }
}

욕조를 비웁니다.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": false
  }
}

욕조의 절반을 채웁니다.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "half_level"
  }
}

욕조 수준을 1만큼 높입니다 (ordered 속성이 true여야 함).

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "full_level"
  }
}

기기 ERRORS

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