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

action.devices.traits.Fill - 이 트레이트는 욕조와 같이 채우기를 지원하는 기기에 적용됩니다.

기기 속성

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

속성 유형 설명
availableFillLevels 객체

기기를 채우는 여러 수준을 설명합니다.
levels 배열

필수사항.

수준 이름 및 언어별 동의어 목록입니다.
[item, ...] 객체

수준 이름 및 언어별 동의어입니다.
level_name 문자열

필수사항.

수준의 내부 이름입니다. 사용자 친화적이지 않을 수 있으며 모든 언어에서 공유됩니다.
level_values 배열

필수사항.

지원되는 각 언어의 수준 동의어입니다.
[item, ...] 객체

특정 언어의 수준 동의어입니다. 언어 대체 수단을 제공하려면 lang 값이 en인 항목이 하나 이상 필요합니다.
level_synonym 배열

필수사항.

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

동의어 이름입니다. 언어 대체 수단을 제공하려면 lang 값이 en인 항목이 하나 이상 필요합니다.
lang 문자열

필수사항.

언어 코드 (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
  }
}

기기 상태

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

주 유형 설명
isFilled Boolean

필수사항.

기기가 어느 수준으로든 채워져 있으면 true입니다. 기기가 완전히 비워져 있으면 false입니다.
currentFillLevel 문자열

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

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

값은 0에서 100 사이여야 합니다.

예

욕조가 채워져 있나요?

{
  "isFilled": true
}

욕조가 채워져 있나요? (수준 포함).

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

기기 명령어

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

action.devices.commands.Fill

기기를 채우거나 비웁니다.

매개변수

매개변수 유형 설명
fill Boolean

필수사항.

채우려면 true, 비우려면 false입니다.
fillLevel 문자열

설정할 availableFillLevels 속성의 level_name을 나타냅니다. 지정하지 않으면 기본 수준으로 채웁니다.
fillPercent 숫자

요청된 수준 백분율을 나타냅니다.

값은 0에서 100 사이여야 합니다.

예

욕조를 채웁니다.

{
  "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"
  }
}

기기 오류

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