Google Home 개발자 센터로의 이전이 완료되었습니다.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

스마트 홈 디스펜스 특성 스키마

action.devices.traits.Dispense - 이 특성은 하나 이상의 실제 상품을 지정된 양만큼 제공하는 기능을 지원하는 기기에 속합니다.

이 특성은 반려동물 급식기의 경우 '고양이 사료 그릇'으로, 수도꼭지의 경우 '유리잔'으로 프리셋을 제공하는 것도 지원합니다.

기기 속성

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

속성	유형	설명
`supportedDispenseItems`	배열	기기에서 디스펜스할 수 있는 모든 항목에 관한 정보를 포함합니다.
`[item, ...]`	객체	디스펜서블 항목입니다.
`item_name`	String	필수사항. 제공된 상품의 내부 이름입니다. 이 방법은 사용자 친화적이지 않으며 모든 언어에서 공유됩니다.
`item_name_synonyms`	배열	필수사항. 지원되는 각 언어로 제공되는 동의어 이름입니다.
`[item, ...]`	객체	특정 언어로 제공된 상품의 동의어 이름입니다. 언어 대체 기능을 제공하려면 `lang` 값이 `en`인 항목이 하나 이상 필요합니다.
`synonyms`	배열	필수사항. 제공된 상품의 동의어 이름입니다. 동의어에는 단수형과 복수형이 모두 포함되어야 합니다(해당하는 경우). 이 목록의 첫 번째 문자열은 해당 언어의 항목 복수형이어야 합니다.
`[item, ...]`	String	동의어 이름입니다. 언어 대체 기능을 제공하려면 `lang` 값이 `en`인 항목이 하나 이상 필요합니다.
`lang`	String	필수사항. 언어 코드 (ISO 639-1) 지원되는 언어를 참고하세요.
`supported_units`	배열	필수사항. 기기에서 해당 항목에 대해 지원하는 단위 집합입니다.
`[item, ...]`	String	지원되는 단위입니다. 지원되는 값: `CENTIMETERS` `CUPS` `DECILITERS` `FLUID_OUNCES` `GALLONS` `GRAMS` `KILOGRAMS` `LITERS` `MILLIGRAMS` `MILLILITERS` `MILLIMETERS` `NO_UNITS` `OUNCES` `PINCH` `PINTS` `PORTION` `POUNDS` `QUARTS` `TABLESPOONS` `TEASPOONS`
`default_portion`	객체	필수사항. 일반적으로 디스펜서에서 나올 수 있는 상품의 양입니다.
`amount`	정수	필수사항. 지급된 금액입니다.
`unit`	String	필수사항. 제공된 단위입니다.
`supportedDispensePresets`	배열	기기에서 지원하는 사전 설정입니다.
`[item, ...]`	객체	사전 설정
`preset_name`	String	필수사항. 사전 설정의 내부 이름입니다. 이 이름은 사용자 친화적이지 않을 수 있으며 모든 언어에서 공유됩니다.
`preset_name_synonyms`	배열	필수사항. 지원되는 각 언어의 사전 설정 동의어 이름입니다.
`[item, ...]`	객체	특정 언어의 사전 설정에 대한 동의어 이름입니다.
`synonyms`	배열	필수사항. 사전 설정의 동의어 이름입니다. 동의어에는 단수형과 복수형이 모두 포함되어야 합니다(해당하는 경우).
`[item, ...]`	String	동의어 이름
`lang`	String	필수사항. 언어 코드 (ISO 639-1) 지원되는 언어를 참고하세요.

예

사전 설정이 있는 액체 단위를 지원하는 물 디스펜서

{
  "supportedDispenseItems": [
    {
      "item_name": "Water",
      "item_name_synonyms": [
        {
          "lang": "en",
          "synonyms": [
            "Water"
          ]
        }
      ],
      "supported_units": [
        "TEASPOONS",
        "TABLESPOONS",
        "FLUID_OUNCES",
        "CUPS",
        "PINTS",
        "QUARTS",
        "GALLONS",
        "MILLILITERS",
        "LITERS",
        "DECILITERS"
      ],
      "default_portion": {
        "amount": 2,
        "unit": "CUPS"
      }
    }
  ],
  "supportedDispensePresets": [
    {
      "preset_name": "cat_bowl",
      "preset_name_synonyms": [
        {
          "lang": "en",
          "synonyms": [
            "Cat water bowl",
            "Cat water dish",
            "Cat water cup"
          ]
        }
      ]
    },
    {
      "preset_name": "glass_1",
      "preset_name_synonyms": [
        {
          "lang": "en",
          "synonyms": [
            "Glass of water",
            "Glass"
          ]
        }
      ]
    }
  ]
}

사전 설정이 없는 반려동물 사료 디스펜서

{
  "supportedDispenseItems": [
    {
      "item_name": "Treat",
      "item_name_synonyms": [
        {
          "lang": "en",
          "synonyms": [
            "Treats",
            "Dog treats",
            "Treat",
            "Dog treat"
          ]
        }
      ],
      "supported_units": [
        "NO_UNITS"
      ],
      "default_portion": {
        "amount": 1,
        "unit": "NO_UNITS"
      }
    }
  ]
}

기기 상태

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

주	유형	설명
`dispenseItems`	배열	기기에서 디스펜서할 수 있는 항목의 상태입니다.
`[item, ...]`	객체	특정 항목의 상태입니다.
`itemName`	String	`item_name` 속성의 상품 이름입니다.
`amountRemaining`	객체	기기에 남아 있는 해당 항목의 양입니다. 기기가 현재 분배 중인 경우 남은 양 또는 기기가 분배를 완료한 후의 양을 보고합니다.
`amount`	숫자	남은 금액
`unit`	String	`supported_units` 속성의 `amount` 단위입니다.
`amountLastDispensed`	객체	기기에서 가장 최근에 분배한 해당 항목의 양입니다. 기기가 현재 분배 중인 경우 현재 분배량 이전의 분배량을 보고해야 합니다.
`amount`	숫자	남은 금액
`unit`	String	`supported_units` 속성의 `amount` 단위입니다.
`isCurrentlyDispensing`	Boolean	기기가 현재 이 항목을 디스펜싱하고 있는지 나타냅니다.

예

디스펜서에 간식이 얼마나 남아 있어?

{
  "dispenseItems": [
    {
      "itemName": "Dog treats",
      "amountRemaining": {
        "amount": 83,
        "unit": "NO_UNITS"
      },
      "amountLastDispensed": {
        "amount": 2,
        "unit": "NO_UNITS"
      },
      "isCurrentlyDispensing": false
    }
  ]
}

내 정수기에 물이 얼마나 남아 있어?

{
  "dispenseItems": [
    {
      "itemName": "Water",
      "amountRemaining": {
        "amount": 6.2,
        "unit": "GALLONS"
      },
      "amountLastDispensed": {
        "amount": 1,
        "unit": "CUPS"
      },
      "isCurrentlyDispensing": false
    }
  ]
}

이전에 고양이 사료를 얼마나 줬지?

{
  "dispenseItems": [
    {
      "itemName": "cat_food",
      "amountRemaining": {
        "amount": 16.5,
        "unit": "CUPS"
      },
      "amountLastDispensed": {
        "amount": 2.5,
        "unit": "CUPS"
      },
      "isCurrentlyDispensing": false
    }
  ]
}

수도꼭지에서 물이 계속 나오나요?

{
  "dispenseItems": [
    {
      "itemName": "Water",
      "isCurrentlyDispensing": true
    }
  ]
}

amountRemaining 및 amountLastDispensed은 하나의 측정 단위를 사용하여 보고하면 됩니다.

dispenseItems 배열 내에 여러 항목을 제공할 수 있습니다. 각 항목 이름은 고유해야 하며 supportedDispenseItems 속성의 항목에 해당해야 합니다.

기기 명령어

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

`action.devices.commands.Dispense`

상품을 배출합니다.

매개변수

페이로드에는 다음 중 하나가 포함됩니다.

금액으로 지급합니다.

매개변수 유형 설명

매개변수	유형	설명
`item`	String	`item_name` 속성에서 가져온 디스펜서에 넣을 항목의 이름입니다.
`amount`	숫자	필수사항. 디스펜서에서 내보낼 금액입니다.
`unit`	String	필수사항. `supported_units` 속성의 `amount` 단위입니다.

item

String

item_name 속성에서 가져온 디스펜서에 넣을 항목의 이름입니다.

amount

숫자

필수사항.

디스펜서에서 내보낼 금액입니다.

unit

String

필수사항.

supported_units 속성의 amount 단위입니다.

사전 설정에 따라 디스펜서에서 제공

매개변수 유형 설명

매개변수	유형	설명
`presetName`	String	필수사항. `preset_name` 속성에서 가져올 사전 설정의 이름입니다.

presetName

String

필수사항.

preset_name 속성에서 가져올 사전 설정의 이름입니다.

매개변수 없이 디스펜서

매개변수	유형	설명
속성이 없습니다.

예

물 1컵 줘.

{
  "command": "action.devices.commands.Dispense",
  "params": {
    "amount": 1,
    "unit": "CUPS",
    "item": "Water"
  }
}

고양이 물그릇을 채워 줘.

{
  "command": "action.devices.commands.Dispense",
  "params": {
    "presetName": "cat_bowl"
  }
}

물을 내보내 줘.

{
  "command": "action.devices.commands.Dispense",
  "params": {}
}

기기 오류

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

dispenseAmountRemainingExceeded: 사용자가 잔액이 충분하지 않은 기기에서 상품 또는 금액을 지급하려고 했습니다.
dispenseAmountAboveLimit: 사용자가 단일 쿼리에서 요청할 수 있는 한도를 초과하는 금액을 지급하려고 했습니다. 이는 실수로 과도한 양 (예: 물 500,000컵)을 분배하는 것을 방지하기 위한 것입니다.
dispenseAmountBelowLimit: 사용자가 기기에서 기기가 출금할 수 있는 최소 금액 미만의 상품 또는 금액을 출금하려고 했습니다.
dispenseFractionalAmountNotSupported: 사용자가 기기에서 나눌 수 없는 항목의 일부를 배출하려고 했습니다 (예: 개 간식과 같은 셀 수 있는 항목은 기기에서 나눌 수 없음).
genericDispenseNotSupported: 사용자가 항목이나 사전 설정을 지정하지 않고 기기에서 디스펜스를 시도하지만 기기에서 이러한 기능을 지원하지 않습니다(예: 기본 디스펜스 작업).
dispenseUnitNotSupported: 사용자가 해당 케이스에 지원되지 않는 단위가 있는 기기에서 디스펜스를 시도합니다 (예: 상품이 제공되지 않아 supported_unit validation이 건너뛰어짐).
dispenseFractionalUnitNotSupported: 사용자가 분할할 수 있지만 지정된 특정 단위로는 분할할 수 없는 항목의 일부를 분배하려고 했습니다 (예: 수도꼭지에서 2.7컵은 분배할 수 있지만 2.7mL는 분배할 수 없음).
deviceCurrentlyDispensing: 사용자가 상품을 배출하려고 하지만 기기에서 이미 배출 중입니다.
deviceClogged: 사용자가 상품을 배출하려고 하지만 기기가 막혔습니다.
deviceBusy: 사용자가 상품을 배출하려고 하지만 기기가 사용 중입니다 (일반).

기기 예외

이러한 예외는 응답의 states 객체에서 exceptionCode로 보고될 수 있습니다.

amountRemainingLow - 사용자가 기기에서 상품 또는 금액을 지급하여 남은 금액이 낮은 수준으로 떨어집니다. '낮은' 수준을 구성하는 요소를 정의할 책임은 사용자에게 있습니다.
userNeedsToWait - 요청된 상품 또는 금액이 성공적으로 지급될 때까지 사용자가 기다려야 하는 경우 (예: 수도꼭지에서 뜨거운 물이 나오지만 사용자가 물이 데워질 때까지 기다려야 지급이 시작됨)