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

스마트 홈 TemperatureControl 특성 스키마

action.devices.traits.TemperatureControl - 기기 내부 또는 주변에서 온도 제어를 지원하는 기기 (온도 조절기 제외)의 특성입니다.

이는 온도 조절기 스타일 컨트롤에 해당하는 TemperatureSetting 특성과는 다릅니다. TemperatureSetting 특성은 주변 (방/실외) 온도를 나타내며 특정 기기의 온도를 제어하는 데 사용해서는 안 됩니다. 특정 기기의 온도를 제어하려면 TemperatureControl 특성을 사용해야 합니다.

기기 속성

이 특성이 있는 기기는 SYNC 작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

속성 유형 설명
temperatureRange 객체

필수.

기기의 지원되는 온도 범위입니다.
minThresholdCelsius Number

필수.

범위의 최저 온도(섭씨)입니다.
maxThresholdCelsius Number

필수.

범위의 최대 온도(섭씨)입니다.
temperatureStepCelsius Number

상대 온도 단계를 지정합니다. 이는 기기에서 지원하는 최소 조정 간격입니다. 지정하지 않으면 상대 단계가 temperatureRange의 백분율로 계산됩니다.
temperatureUnitForUX String

필수.

사용자 응답에 사용되는 온도 단위입니다.

지원 값:

C
F
commandOnlyTemperatureControl Boolean

(기본값: false)

기기가 단방향 (true) 또는 양방향 (false) 통신을 사용하도록 지원하는지 나타냅니다. 기기가 이 특성에 관해 QUERY 인텐트 또는 보고서 상태에 응답할 수 없는 경우 이 속성을 true로 설정하세요.
queryOnlyTemperatureControl Boolean

(기본값: false)

기기가 쿼리 전용 실행을 지원하는 경우 필요합니다. 이 속성은 기기를 상태 정보에 대해서만 쿼리할 수 있으며 제어할 수 없는지 여부를 나타냅니다.

예

화씨 150~500도의 제어를 지원하는 기기(5도 단위)

{
  "temperatureRange": {
    "minThresholdCelsius": 65.5,
    "maxThresholdCelsius": 260
  },
  "temperatureStepCelsius": 2.778,
  "temperatureUnitForUX": "F"
}

기기 상태

이 특성이 있는 기기는 QUERY 작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

상태 유형 설명
temperatureSetpointCelsius Number

현재 온도 설정값(섭씨)입니다. temperatureRange 내에 속해야 합니다. queryOnlyTemperatureControl가 false로 설정된 경우 필수사항
temperatureAmbientCelsius Number

현재 관찰된 온도(섭씨)입니다. temperatureRange 내에 속해야 합니다.

예

기기의 온도는 어떻게 설정되어 있나요?

{
  "temperatureSetpointCelsius": 150
}

기기 명령어

이 특성이 있는 기기는 EXECUTE 작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

action.devices.commands.SetTemperature

온도를 특정 값으로 설정합니다.

매개변수

매개변수 유형 설명
temperature Number

필수.

설정할 온도(섭씨)입니다. temperatureRange 내에 속해야 합니다.

예

기기를 화씨 350도로 설정합니다.

{
  "command": "action.devices.commands.SetTemperature",
  "params": {
    "temperature": 176.67
  }
}

희망 온도를 설정하는 중에 오류가 발생했습니다.

지원 값:

alreadyAtMax
alreadyAtMin
valueOutOfRange

샘플 발화

de-DE

  • Erhöhe die Temperatur des Ofens
  • Stelle die Temperatur des Ofens auf 425 Grad

en-US

  • I want the temperature of the oven higher
  • set the oven to 400

es-ES

  • pon la temperatura del horno a 180 grados
  • sube la temperatura del horno

fr-FR

  • Mets la température du four à 180 degrés .
  • augmente la température du four

hi-IN

  • ओवन का तापमान 425 डिग्री पर करें

it-IT

  • Alza la temperatura del forno
  • metti il forno a 200 gradi

ja-JP

  • オーブン の温度を 425度 に設定して
  • オーブン の温度を上げて

ko-KR

  • 오븐 온도 180 도로 맞춰
  • 오븐 온도 좀 높여 줄래

nl-NL

  • stel de oven in op 220 graden
  • verhoog de temperatuur van de oven

pt-BR

  • ajuste a temperatura do forno para 180 graus
  • aumenta a temperatura do forno
  • aumentar a temperatura do forno
  • define a temperatura do termostato nos 22 graus

sv-SE

  • höj temperaturen i ugnen
  • sätt ugnen på 100 grader

기기 오류

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