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

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

기기 상태

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

상태	유형	설명
isFilled	Boolean	필수. 기기가 모든 수준으로 채워지면 true입니다. 기기가 완전히 드레이닝되면 false입니다.
currentFillLevel	String	availableFillLevels 속성이 설정된 경우 필수입니다. 기기가 채워진 availableFillLevels 속성의 현재 level_name를 나타냅니다.
currentFillPercent	Number	supportsFillPercent 속성이 설정된 경우 필수입니다. 현재 채우기 수준 백분율을 나타냅니다.

예

욕조가 채워져 있나요?

{
  "isFilled": true
}

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

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

기기 명령어

이 특성이 있는 기기는 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"
  }
}

기기 오류

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