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

스마트 홈 온도 설정 특성 스키마

action.devices.traits.TemperatureSetting - 이 특성은 온도 지점과 모드 모두를 처리합니다.

기기 속성

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

속성 유형 설명
availableThermostatModes

필수사항.

기기에서 지원할 수 있는 온도 조절기 모드를 설명합니다.

다음 중 하나를 지원합니다.
0 String

지원 중단됨

이 특정 기기에서 지원하는 쉼표로 구분된 모드 목록 새 통합에서는 이 속성의 Array 형식을 사용해야 합니다.

1 배열

이 특정 기기에서 지원하는 모드 목록

[item, ...] String

지원되는 모드 이름입니다.

지원 값:

off
난방/냉방 활동 사용 중지됨
heat
난방 지원 기기
cool
기기 냉각 지원
on
기기의 이전 모드를 복원합니다. on 모드는 설계상 기기의 이전 모드를 복원하는 데 사용되므로 on 모드는 모드 선택 화면에 표시되지 않습니다.
heatcool
범위: 난방/냉방 목표 유지
auto
일정 또는 학습 행동에 따라 온도가 설정된 자동 모드
fan-only
팬이 난방/냉방 활동으로 활동하지 않음
purifier
정화 모드
eco
에너지 절약 모드
dry
건식 모드
thermostatTemperatureRange 객체

이 기기에 지원되는 온도 범위를 나타내는 부동 소수점 값 2개가 포함됩니다 (섭씨).

minThresholdCelsius Number

필수사항.

온도 범위의 최소 기준치입니다.

maxThresholdCelsius Number

필수사항.

온도 범위의 최대 기준치입니다.

thermostatTemperatureUnit String

필수사항.

기기가 기본적으로 설정된 디스플레이 단위입니다. Google은 디스플레이 단위를 사용하여 온도 정보를 보고합니다.

지원 값:

C
F
bufferRangeCelsius Number

(기본값: 2)

heatcool 모드가 지원되는 경우 냉난방 설정값 간의 최소 오프셋을 섭씨로 지정합니다.

commandOnlyTemperatureSetting Boolean

(기본값: false)

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

queryOnlyTemperatureSetting Boolean

(기본값: false)

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

개별 난방 및 냉방을 지원하는 온도 조절기

{
  "availableThermostatModes": [
    "off",
    "heat",
    "cool",
    "on"
  ],
  "thermostatTemperatureUnit": "F"
}

명령어 전용 온도 조절기

{
  "availableThermostatModes": [
    "off",
    "heat",
    "cool",
    "on"
  ],
  "thermostatTemperatureUnit": "C",
  "commandOnlyTemperatureSetting": true,
  "queryOnlyTemperatureSetting": false
}

기기 상태

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

상태 유형 설명
activeThermostatMode String

availableThermostatModes 목록에서 가져온 기기의 현재 활성 모드입니다. 현재 활성화된 모드가 없는 경우 none로 설정합니다.

지원 값:

none
활성 모드 없음
off
난방/냉방 활동 사용 중지됨
heat
난방 지원 기기
cool
기기 냉각 지원
on
기기의 이전 모드를 복원합니다. on 모드는 설계상 기기의 이전 모드를 복원하는 데 사용되므로 on 모드는 모드 선택 화면에 표시되지 않습니다.
heatcool
범위: 난방/냉방 목표 유지
auto
일정 또는 학습 행동에 따라 온도가 설정된 자동 모드
fan-only
팬이 난방/냉방 활동으로 활동하지 않음
purifier
정화 모드
eco
에너지 절약 모드
dry
건식 모드
targetTempReachedEstimateUnixTimestampSec 정수

목표 온도에 도달할 것으로 예상되는 시간을 나타내는 타임스탬프입니다.

thermostatHumidityAmbient Number

기기에서 지원하는 경우 주변 습도의 상대 수준을 나타냅니다.

다음 항목 중 하나가 포함되어 있습니다.
0 객체

고정된 설정 지점의 상태입니다.

thermostatMode String

필수사항.

availableThermostatModes 목록에서 가져온 기기의 현재 모드입니다.

지원 값:

none
활성 모드 없음
off
난방/냉방 활동 사용 중지됨
heat
난방 지원 기기
cool
기기 냉각 지원
on
기기의 이전 모드 복원
heatcool
범위: 난방/냉방 목표 유지
auto
일정 또는 학습 행동에 따라 온도가 설정된 자동 모드
fan-only
팬이 난방/냉방 활동으로 활동하지 않음
purifier
정화 모드
eco
에너지 절약 모드
dry
건식 모드
thermostatTemperatureAmbient Number

필수사항.

현재 관찰된 온도(섭씨)입니다.

thermostatTemperatureSetpoint Number

필수사항.

현재 온도 설정값 (단일 타겟), 도 단위입니다.

1 객체

설정된 포인트 범위의 상태입니다.

thermostatMode String

필수사항.

availableThermostatModes 목록에서 가져온 기기의 현재 모드입니다.

지원 값:

none
활성 모드 없음
off
난방/냉방 활동 사용 중지됨
heat
난방 지원 기기
cool
기기 냉각 지원
on
기기의 이전 모드 복원
heatcool
범위: 난방/냉방 목표 유지
auto
일정 또는 학습 행동에 따라 온도가 설정된 자동 모드
fan-only
팬이 난방/냉방 활동으로 활동하지 않음
purifier
정화 모드
eco
에너지 절약 모드
dry
건식 모드
thermostatTemperatureAmbient Number

필수사항.

현재 관찰된 온도(섭씨)입니다.

thermostatTemperatureSetpointHigh Number

필수사항.

heatcool 모드인 경우 현재 최고점

thermostatTemperatureSetpointLow Number

필수사항.

heatcool 모드인 경우 현재 낮은 포인트

현재 기기 온도는 몇 도인가요?

{
  "activeThermostatMode": "cool",
  "thermostatMode": "cool",
  "thermostatTemperatureSetpoint": 23,
  "thermostatTemperatureAmbient": 25.1
}

현재 기기 온도는 몇 도인가요?

{
  "activeThermostatMode": "none",
  "thermostatMode": "heatcool",
  "thermostatTemperatureSetpointHigh": 26,
  "thermostatTemperatureSetpointLow": 22,
  "thermostatTemperatureAmbient": 25.1
}

기기 명령어

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

action.devices.commands.ThermostatTemperatureSetpoint

온도 조절기의 희망 온도를 설정합니다.

매개변수

매개변수 유형 설명
thermostatTemperatureSetpoint Number

필수사항.

목표 온도 설정값 소수점 이하 최대 1자리까지 지원됩니다.

기기 온도를 22도로 설정해 줘.

{
  "command": "action.devices.commands.ThermostatTemperatureSetpoint",
  "params": {
    "thermostatTemperatureSetpoint": 22
  }
}

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

지원 값:

alreadyAtMax
alreadyAtMin
targetAlreadyReached
valueOutOfRange

action.devices.commands.ThermostatTemperatureSetRange

온도 조절기의 목표 온도 범위를 설정합니다.

이 명령어에는
{
  "availableThermostatModes": [
    "heatcool"
  ]
}
속성이 필요합니다.

매개변수

매개변수 유형 설명
thermostatTemperatureSetpointHigh Number

필수사항.

범위에 대한 높은 목표 설정값입니다. heatcool 모드 지원이 필요합니다.

thermostatTemperatureSetpointLow Number

필수사항.

범위의 목표 설정값이 낮습니다. heatcool 모드 지원이 필요합니다.

온도를 22~26도로 유지합니다.

{
  "command": "action.devices.commands.ThermostatTemperatureSetRange",
  "params": {
    "thermostatTemperatureSetpointHigh": 26,
    "thermostatTemperatureSetpointLow": 22
  }
}

대상 범위를 설정하는 중에 오류가 발생했습니다.

지원 값:

alreadyAtMax
alreadyAtMin
lockedToRange
rangeTooClose
targetAlreadyReached
valueOutOfRange

action.devices.commands.ThermostatSetMode

온도 조절기의 타겟 작동 모드를 설정합니다.

매개변수

매개변수 유형 설명
thermostatMode String

필수사항.

availableThermostatModes 모드인 타겟 모드

지원 값:

off
난방/냉방 활동 사용 중지됨
heat
난방 지원 기기
cool
기기 냉각 지원
on
기기의 이전 모드 복원
heatcool
범위: 난방/냉방 목표 유지
auto
일정 또는 학습 행동에 따라 온도가 설정된 자동 모드
fan-only
팬이 난방/냉방 활동으로 활동하지 않음
purifier
정화 모드
eco
에너지 절약 모드
dry
건식 모드

기기를 냉난방 모드로 설정합니다.

{
  "command": "action.devices.commands.ThermostatSetMode",
  "params": {
    "thermostatMode": "heatcool"
  }
}

대상 모드를 설정하는 중에 오류가 발생했습니다.

지원 값:

inAutoMode
inAwayMode
inDryMode
inEcoMode
inFanOnlyMode
inHeatOrCool
inHumidifierMode
inOffMode
inPurifierMode

action.devices.commands.TemperatureRelative

현재 상태를 기준으로 목표 온도를 조정합니다.

이 명령어에는
{
  "commandOnlyTemperatureSetting": true
}
속성이 필요합니다.

매개변수

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

각도로 조정합니다.

매개변수 유형 설명
thermostatTemperatureRelativeDegree Number

필수사항.

온도를 변경할 수 있는 정확한 각도입니다 (예: '5도 낮춰 줘').

체중을 기준으로 조정

매개변수 유형 설명
thermostatTemperatureRelativeWeight 정수

필수사항.

온도가 모호한 정도를 '약간 낮추기'에서 크게 '큰 따뜻함'으로 변경하는 것입니다.

온도를 5도 높여 줘

{
  "command": "action.devices.commands.TemperatureRelative",
  "params": {
    "thermostatTemperatureRelativeDegree": 5
  }
}

온도를 많이 낮춤

{
  "command": "action.devices.commands.TemperatureRelative",
  "params": {
    "thermostatTemperatureRelativeWeight": -5
  }
}

온도를 조절하는 중에 오류가 발생했습니다.

지원 값:

alreadyAtMax
alreadyAtMin
valueOutOfRange

샘플 발화

de-DE

  • 헤이즈모더스 애니메이션
  • 마하 덴 헤이즈모스 오스트레일리아
  • Schalt den Heizmodus vom Thermostat aus
  • 템페라우 우프 20bis 25 Grad einstellen.
  • 온도 조절기 auf 20bis 25 Grad 별.
  • 온도 조절기 임 슐라프머 kälter stellen
  • Wohnzimmer auf Kühlen umstellen
  • Bitte dreh das Thermostat ein bisschen Herunter
  • Bitte dreh das Thermostat etwas höher
  • Bitte mach es im Wohnzimmer kühler
  • Bitte mach es in der Küche etwas kälter
  • Bitte stell das Thermostat 5 Grad wärmer ein
  • Bitte stell das Thermostat auf 21 Grad für Kühlen ein
  • Bitte stell das Thermostat auf 30 Grad
  • Bitte stell die Temperatur im Schlafzimmer auf 20 Grad
  • dreh das Thermostat Wärmer Bitte
  • dreh die Temperatur im Schlafzimmer etwas nach oben
  • dreh die Temperatur um 5 Grad runer
  • 에르호헤 비트테 디 템페라투어 im Bad
  • erhöhe die Temperatur um 2그라드
  • im Wohnzimmer 2 Grad wärmer
  • Senke die Temperatur im Wohnzimmer 5 Grad
  • stell Bitte das Thermostat auf Kühlen
  • stell das Thermostat 5 Grad kälter ein
  • stell die Kühlung auf 20 Grad ein

en-US

  • 난방 모드를 사용 중지합니다.
  • 온도 조절기 난방 70~80도
  • 절전 모드로 변경
  • 거실에서 냉방
  • 열을 식히세요. 집 안 약간
  • 온도 조절기의 온도 높이기
  • 온도 조절기 78
  • 더 따뜻하게 해 줘 더 따뜻하게 2도
  • 더 시원하게 해 줘 2도
  • 온도 조절기 더 따뜻하게 약간
  • 모드 켜기 냉방 모드
  • 온도 조절기 냉방
  • 아래층 2도 높이기
  • 온도 조절기의 온도를 5도 높이기
  • 온도 조절기 20도 설정
  • 냉방 모드 62 ~ 79도로 설정
  • 온도 설정 80도
  • 난방 72
  • 온도를 냉방으로 설정합니다. 70
  • 온도 조절기 70 냉방 모드 설정
  • 온도 조절기 5도 온도를 낮춥니다.
  • 거실 꺼 줘 2도
  • 온도 조절기 난방 모드 꺼 줘
  • 온도 조절기조금 낮습니다.
  • 온도 조절기 온도를 낮추세요.
  • 거실 준비
  • 예열 거실 약간

es-ES

  • 25그라드 de frío la cocina
  • 아후타르 el termostato entre 21 y 26 grados
  • 아후스타 라 템페라투라 21 년 27년 전 학기
  • Activar el modo calefacción
  • 아파가르 엘 에어 아콘디시오도테르모토
  • aumenta 10개의 경사 라 템페라투라 델 혼로
  • aumenta la temperatura de la cocina
  • 바자 알고 라 칼레파치온
  • 바하 라 템페라투라 5그라드
  • 바하 라 템페라투라 델 termostato
  • configurar el modo calefacción
  • Disminuyes la temperatura de la cocina un poco
  • Hace demasiado calor aquí
  • 메아후사스 25학년도 el modo calor
  • me gustaría ajustar el termostato del salón 25 grados con la calefacción
  • 20그라드 라 템페라투라
  • on en modo calefacción el termostato de la cocina
  • Pon la temperatura de la cocina a 20그라드
  • 푸에데스 수비르 un poco la temperatura en el salón
  • quiero bajar el nest 5 Gros
  • quiero el modo aire acondicionado a 25가지의 교육 과정
  • quitar el modo fríobaño
  • sube 경사 5개 en la cocina
  • sube la calefacción
  • 수베메 el termostato del salón un poquito
  • súbeme más la temperatura 10그라스

fr-FR

  • Allumer le mode chaud .
  • Mes en mode chaud .
  • 메츠 라 온도 entre 21 et 23 degrés .
  • Mets la température à 17 degrés
  • Met le mode 냉각기 du 온도 조절기 à 19 degrés .
  • MART LE 모드 Froid HA 19 degrés .
  • 메틀레 le 온도 조절기 entre 70 et 80 degrés .
  • Régler le mode chaud du 온도 조절기 à 22 degrés .
  • Régler le mode chaud à 22 degrés
  • 증강 현실 온도 2도
  • 증강 un peu la température dans la chambre
  • Baisse la température de la chambre
  • Baisse le 온도 조절기
  • un peu 라 템페라추 댄 요리
  • un peu le 온도 조절기
  • 베이저 le 온도 조절기 de
  • 쿠페 LE 모드 chaud
  • 기온: 하강 3도
  • désactiver le 모드 프랑스 du 온도 조절기
  • 메츠 le 온도 조절기 en 모드 frais
  • 메츠 le 온도 조절기 à degrés 10개
  • Metre degrés 2 de moins dans la cuisine
  • 몬테 라 온도 드 라 샴브레
  • 몬테 라 템페라허 드 la salle de bain de 3 degrés
  • 몬테 르 온도 조절기
  • 몬테 르 온도 조절기 de 데그리스 2개
  • 몬테 un peu le 온도 조절기
  • Éteins le mode chaud du 온도 조절기 .

기기 오류

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