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

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

기기 ATTRIBUTES

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

기기 오류

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