스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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

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

기기 오류

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