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

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

기기 속성

이 특성이 있는 기기는 SYNC 작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC 인텐트 처리에 대해 자세히 알아보려면 인텐트 처리를 참고하세요.

속성	유형	설명
availableFillLevels	객체	기기를 채우는 다양한 수준을 설명합니다.
levels	배열	필수사항. 레벨 이름과 언어별 동의어 목록입니다.
[item, ...]	객체	레벨 이름과 언어별 동의어입니다.
level_name	String	필수사항. 레벨의 내부 이름입니다. 이 경우 사용자 친화적이지 않으며 모든 언어에 공유됩니다.
level_values	배열	필수사항. 지원되는 각 언어의 레벨 동의어입니다.
[item, ...]	객체	지정된 언어의 레벨 동의어입니다. 언어 대체 기능을 제공하려면 lang 값이 en인 항목이 하나 이상 필요합니다.
level_synonym	배열	필수사항. 레벨의 동의어입니다. 이 목록의 첫 번째 문자열은 해당 언어의 레벨 표준 이름으로 사용됩니다.
[item, ...]	String	동의어 이름입니다. 언어 대체 기능을 제공하려면 lang 값이 en인 항목이 하나 이상 필요합니다.
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	숫자	supportsFillPercent 속성이 설정된 경우 필수입니다. 현재 채우기 수준 비율을 나타냅니다.

예

욕조가 채워져 있나요?

{
  "isFilled": true
}

욕조가 채워져 있나요? (레벨 포함)

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

기기 명령어

이 특성이 있는 기기는 EXECUTE 작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE 인텐트 처리에 대해 자세히 알아보려면 인텐트 처리를 참고하세요.

action.devices.commands.Fill

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

매개변수

매개변수	유형	설명
fill	Boolean	필수사항. 채우려면 true, 비우려면 false입니다.
fillLevel	String	설정할 availableFillLevels 속성의 level_name을 나타냅니다. 지정하지 않으면 기본 수준까지 채웁니다.
fillPercent	숫자	요청된 레벨 비율을 나타냅니다.

예

욕조를 채워 줘.

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

기기 오류

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