스마트 홈 채우기 트레잇 스키마

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 숫자

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

기기 ERRORS

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