歡迎使用 Google Home 開發人員中心,探索全新功能,瞭解如何開發智慧住宅動作。注意:請繼續在「動作」控制台中建立動作。
透過集合功能整理內容 你可以依據偏好儲存及分類內容。

智慧型住宅溫度設定特性結構定義

action.devices.traits.TemperatureSetting - 此屬性涵蓋處理溫度點和模式。

裝置屬性

具有此特性的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖,請參閱意圖執行要求一文。

屬性 類型 說明
availableThermostatModes

必填。

說明這個裝置可支援的溫度控制器模式。

支援下列其中一種做法:
0 字串

已淘汰

此裝置支援的模式清單 (以半形逗號分隔)。新整合應使用這個屬性的 Array 表單。

1 陣列

此裝置支援的模式清單。

[item, ...] 字串

支援的模式名稱。

支援的值:

off
已停用暖氣/冷氣活動
heat
裝置支援暖氣
cool
裝置支援冷卻功能
on
還原裝置的上一個模式。on 模式不會顯示在設計選項畫面中,因為在設計時,on 模式是用來還原裝置的上一個模式。
heatcool
將暖氣/冷氣範圍維持在範圍
auto
自動設定溫度模式,按照時間表或學習行為設定溫度
fan-only
在沒有熱 • 冷活動的情況下執行風扇
purifier
清除模式
eco
節能模式
dry
乾燥模式
thermostatTemperatureRange 物件

含有兩個浮點值,表示裝置支援的溫度範圍 (以攝氏為單位)。

minThresholdCelsius Number

必填。

溫度範圍的最低門檻。

maxThresholdCelsius Number

必填。

溫度範圍的最大門檻。

thermostatTemperatureUnit 字串

必填。

裝置的預設顯示單位。Google 使用顯示單位回報溫度資訊。

支援的值:

C
F
bufferRangeCelsius Number

(預設:2)

指定熱 • 冷氣設定點之間的最小偏移值 (以攝氏為單位),前提是支援 heatcool 模式。

commandOnlyTemperatureSetting 布林

(預設:false)

指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應此特徵的 QUERY 意圖或報告狀態,請將此屬性設為 true。

queryOnlyTemperatureSetting 布林

(預設:false)

如果裝置支援查詢功能,則為必要屬性。這個屬性可指出裝置是否只能查詢狀態資訊,而且無法控制。

範例

支援離散暖氣和冷氣的溫度控制器裝置

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

指令式溫度控制器裝置

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

裝置狀態:STATE

具有此特性的裝置可能會在 QUERY 作業中回報下列狀態。如要進一步瞭解如何處理 QUERY 意圖,請參閱意圖執行要求一文。

類型 說明
activeThermostatMode 字串

裝置目前為 availableThermostatModes 模式的啟用模式。如果目前未使用任何模式,請將模式設為 none

支援的值:

none
沒有使用中的模式
off
已停用暖氣/冷氣活動
heat
裝置支援暖氣
cool
裝置支援冷卻功能
on
還原裝置的上一個模式。on 模式不會顯示在設計選項畫面中,因為在設計時,on 模式是用來還原裝置的上一個模式。
heatcool
將暖氣/冷氣範圍維持在範圍
auto
自動設定溫度模式,按照時間表或學習行為設定溫度
fan-only
在沒有熱 • 冷活動的情況下執行風扇
purifier
清除模式
eco
節能模式
dry
乾燥模式
targetTempReachedEstimateUnixTimestampSec 整數

時間戳記,代表將達到目標溫度的預估時間。

thermostatHumidityAmbient Number

代表環境濕度的相對等級 (如果裝置支援的話)。

內含下列其中一個項目:
0 物件

固定設定點的州別。

thermostatMode 字串

必填。

裝置的目前模式 (來自 availableThermostatModes 清單)。

支援的值:

none
沒有使用中的模式
off
已停用暖氣/冷氣活動
heat
裝置支援暖氣
cool
裝置支援冷卻功能
on
還原裝置的上一個模式
heatcool
將暖氣/冷氣範圍維持在範圍
auto
自動設定溫度模式,按照時間表或學習行為設定溫度
fan-only
在沒有熱 • 冷活動的情況下執行風扇
purifier
清除模式
eco
節能模式
dry
乾燥模式
thermostatTemperatureAmbient Number

必填。

目前觀察到的溫度,單位為攝氏。

thermostatTemperatureSetpoint Number

必填。

目前溫度設定點 (單一目標),單位為攝氏。

1 物件

設定點範圍的狀態。

thermostatMode 字串

必填。

裝置的目前模式 (來自 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 字串

必填。

目標模式,從 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

  • Heizmodus anmachen
  • Mach den Heizmodus aus
  • Schalt den Heizmodus vom Thermostat aus
  • Temperatur auf 20 bis 25 Grad einstellen.
  • Thermostat auf 20 bis 25 Grad stellen.
  • Thermostat im Schlafzimmer 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 runter
  • erhöhe bitte die Temperatur im Bad
  • erhöhe die Temperatur um 2 Grad
  • mach es im Wohnzimmer 2 Grad wärmer
  • senke die Temperatur im Wohnzimmer um 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

  • Turn off heat mode.
  • change the thermostat heat cool between 70 and 80
  • change to eco mode
  • cool down in the living room
  • cool down the house a little
  • increase the temperature on the thermostat
  • maintain the thermostat heat at 78
  • make it 2 degrees warmer
  • make it cooler by 2 degrees
  • make thermostat warmer a little bit
  • put on cooling mode
  • put the thermostat on cool
  • raise the temperature downstairs by 2 degrees
  • raise the temperature on thermostat by 5 degrees
  • set 70 degrees on the thermostat
  • set heat cool mode to between 62 and 79 degrees
  • set my temperature 80 degrees
  • set the heat to 72
  • set the temperature to cool at 70
  • set the thermostat at 70 in cool mode
  • turn down 5 degrees on thermostat
  • turn down the living room temp 2 degrees
  • turn off thermostat heat mode
  • turn thermostat a little lower
  • turn thermostat lower
  • warm up the living room
  • warm up the living room a little

es-ES

  • 25 grados de frío en la cocina
  • Ajustar el termostato entre 21 y 26 grados
  • Ajustar la temperatura entre 21 y 27 grados
  • activar el modo calefacción
  • apagar el aire acondicionado del termostato
  • aumenta 10 grados la temperatura del horno
  • aumenta la temperatura de la cocina
  • baja algo la calefacción
  • baja la temperatura 5 grados
  • baja la temperatura del termostato
  • configurar el modo calefacción
  • disminuye la temperatura de la cocina un poco
  • hace demasiado calor aquí
  • me ajustas a 25 grados el modo calor
  • me gustaría ajustar el termostato del salón a 25 grados con la calefacción
  • pon a 20 grados la temperatura
  • pon en modo calefacción el termostato de la cocina
  • pon la temperatura de la cocina a 20 grados
  • puedes subir un poco la temperatura en el salón
  • quiero bajar el nest 5 grados
  • quiero el modo aire acondicionado a 25 grados
  • quitar el modo frío del baño
  • sube 5 grados en la cocina
  • sube la calefacción
  • súbeme el termostato del salón un poquito
  • súbeme más la temperatura 10 grados

fr-FR

  • Allumer le mode chaud .
  • Mets en mode chaud .
  • Mets la température entre 21 et 23 degrés .
  • Mets la température à 17 degrés .
  • Mets le mode froid du thermostat à 19 degrés .
  • Mettre le mode froid à 19 degrés .
  • Mettre le thermostat entre 70 et 80 degrés .
  • Régler le mode chaud du thermostat à 22 degrés .
  • Régler le mode chaud à 22 degrés .
  • augmente la température de 2 degrés
  • augmente un peu la température dans la chambre
  • baisse la température de la chambre
  • baisse le thermostat
  • baisse un peu la température dans la cuisine
  • baisse un peu le thermostat
  • baisser le thermostat de 5 degrés
  • coupe le mode chaud
  • descends la température de 3 degrés
  • désactiver le mode frais du thermostat
  • mets le thermostat en mode frais
  • mets le thermostat à 10 degrés
  • mettre 2 degrés de moins dans la cuisine
  • monte la température de la chambre
  • monte la température de la salle de bain de 3 degrés
  • monte le thermostat
  • monte le thermostat de 2 degrés
  • monte un peu le thermostat
  • Éteins le mode chaud du thermostat .

hi-IN

  • thermostat का हीट 20 तक कर दो
  • कूलिंग को 70 डिग्री पर सेट करो
  • कूलिंग चालू करो
  • कूलिंग मोड को बंद कर दो
  • टेम्परेचर को 17 डिग्री पर सेट कर दो
  • तापमान 2 डिग्री कम करो
  • थर्मोस्टेट 70 डिग्री पर सेट करो
  • थर्मोस्टेट का टेम्प्रेचर ५ डिग्री घटाओ
  • थर्मोस्टेट का टेम्प्रेचर ५ डिग्री बढ़ाओ
  • थर्मोस्टेट का तापमान ज्यादा करो
  • थर्मोस्टेट को कूलिंग मोड में सेट करो
  • थर्मोस्टैट का कूलिंग मोड बंद करोगी
  • थर्मोस्टैट का तापमान ज़्यादा कर दो
  • थर्मोस्टैट के हीटिंग और कूलिंग मोड को 70 और 80 डिग्री के बीच रखें.
  • थर्मोस्टैट को कम कर दो
  • थारमोस्टेट का तापमान थोड़ा कम करें
  • थारमोस्टेट का तापमान थोड़ा बढ़ाओ
  • बेडरूम का टेंप्रेचर 5 डिग्री ज्यादा कर देना
  • बेडरूम का टेंप्रेचर थोड़ा कम कर देना
  • बेडरूम का टेंप्रेचर ज़्यादा कर देना
  • बेडरूम का तापमान थोड़ा ज़्यादा करो
  • मेरे लिए लिविंग रूम का तापमान कम करिये
  • सभी थर्मोस्टैट्स की कूलिंग को 70 डिग्री पर सेट कर दो
  • हीटिंग-कूलिंग मोड 30 और 40 डिग्री के बीच रखो।
  • हीटिंग-कूलिंग मोड पर सेट करो

it-IT

  • Alza di due gradi la temperatura della camera da letto
  • Imposta il termostato tra 20 e 25 gradi .
  • Metti la temperatura tra 15 e 20 gradi .
  • abbassa di 8 in cucina
  • abbassa la temperatura
  • abbassa la temperatura della caldaia
  • abbassa la temperatura della caldaia di 3 gradi
  • abbassa la temperatura di due gradi
  • abbassa leggermente la caldaia
  • alza il termostato
  • aumenta un po' la caldaia
  • disattiva la modalità eco
  • disattiva la modalità eco del riscaldamento della cucina
  • fai aumentare leggermente la temperatura
  • imposta il condizionatore su raffreddamento
  • metti il raffreddamento a 20 gradi
  • metti il termostato a 25
  • metti il termostato in modalità eco
  • metti la modalità condizionatore del termostato a 40 gradi
  • metti la modalità riscaldamento del termostato a 30 gradi
  • metti la temperatura un po' più bassa
  • puoi aumentare di 3 la caldaia
  • puoi mettere più caldo
  • setta 5 gradi più caldo
  • setta la temperatura su 20 gradi
  • voglio l'aria condizionata settata su eco

ja-JP

  • 2 度 暖かくして
  • 2 度 涼しくして
  • エアコン 冷房 の温度を 18 度 にして
  • エアコン 暖房 25 度 にして
  • キッチン 少し 涼しくして
  • キッチン を涼しくして
  • サーモスタット エコ モードを切って
  • サーモスタット の温度 28 度 にして
  • サーモスタット の温度を 10 度 下げて
  • サーモスタット の温度を 2 度 上げて
  • サーモスタット の温度を 20度から25度 にセット
  • サーモスタット の温度を ちょっと 上げて
  • サーモスタット の温度を下げて
  • サーモスタット の温度を高くして
  • サーモスタット の温度 少し 下げて
  • サーモスタット 冷房 に変えて
  • ヒートクール に変更して
  • ヒートクール モードを消して
  • リビング の温度 20 度 にしてください
  • リビング 少し 暖かくして
  • リビング を暖かくして
  • 冷房 モードで 20度 に設定して
  • 冷房 モードオン
  • 台所 の温度 5 度 上げて
  • 温度を 20度から25度 にして

ko-KR

  • 20도에서 30 도 사이로 온도 유지해
  • 거실 24 도로 맞춰 줘
  • 거실 온도 2 도 낮춰 줘
  • 거실 온도 내려 줘
  • 거실 온도 조금만 내려
  • 난방 20 도로 조정해 줘
  • 난방 모드로 바꿔 줘
  • 냉방 20 도로 조정해
  • 냉방 켜 줘
  • 안방 온도 더 올려 줘
  • 온도 2 도 높게 설정
  • 온도 2 도만 내려 줘
  • 온도 조절기 10 도 내려 줘
  • 온도 조절기 20 도로 설정해 줘
  • 온도 조절기 난방 꺼 줘
  • 온도 조절기 난방 모드로 변경해
  • 온도 조절기 낮춰 줘
  • 온도 조절기 온도 10 도 올려
  • 온도 조절기 온도 높여 줘
  • 온도 조절기 온도 조금 낮춰 줘
  • 온도 조절기 온도 조금만 올려
  • 온도 조절기 난방 온도 23 도로 맞춰 놔
  • 온도 조절기 냉방 23 도로 설정해
  • 온도 조절기 70도에서 80 도 사이로 맞춰
  • 침실 온도 2 도 높여 줘
  • 침실 온도 살짝 높여

nl-NL

  • De keuken wat afkoelen
  • De thermostaat op 20 graden zetten
  • Houd de temperatuur tussen 20 en 25 graden .
  • Keuken afkoelen
  • Maak het 2 graden koeler
  • Maak het 2 graden warmer
  • Stel warmtemodus op de thermostaat in op 24 graden
  • Zet afkoelen aan.
  • Zet de koeling op 24 graden .
  • Zet de thermostaat tussen 20 en 25 graden .
  • de keuken een beetje verwarmen
  • de thermostaat een beetje verhogen
  • de thermostaat een beetje verlagen
  • de thermostaat met 5 graden verlagen
  • de thermostaat verhogen
  • de thermostaat verlagen
  • verander naar afkoelen
  • verwarm de keuken
  • zet de koeling op de thermostaat op 16 graden
  • zet de koelstand op de thermostaat uit
  • zet de temperatuur op 25 graden
  • zet de thermostaat op afkoelen
  • zet de verwarmingsstand uit
  • zet warmtemodus op 20 graden

pt-BR

  • Ajustar a refrigeração do termostato para 23 graus
  • Ajustar a refrigeração para 23 graus
  • Ajuste o termostato para ficar entre 15 e 20 graus .
  • Aumentar a temperatura da cozinha .
  • Definir a temperatura como sendo entre 15 e 17 graus .
  • Definir a temperatura do termostato para 30 graus .
  • abaixar dois graus a temperatura
  • abaixar um pouco a temperatura do quarto
  • abaixe a temperatura do quarto
  • ajustar a temperatura do quarto para 20 graus
  • ajustar o aquecimento para 25 graus
  • ajustar o quente do termostato em 25 graus
  • ajustar o termostato para aquecer
  • aquecer a sala um pouco
  • aumenta a temperatura do termostato em 2 graus
  • aumentar a temperatura do termostato
  • aumentar bastante o termostato
  • aumentar três graus a temperatura
  • baixa a temperatura do termostato em 5 graus
  • colocar no frio
  • desativar o modo aquecimento do termostato
  • desativar o modo refrescar
  • diminuir cinco graus a temperatura do escritório
  • diminuir o termostato
  • quero diminuir um pouco o termostato

sv-SE

  • Dra upp temperaturen på termostaten
  • Dra upp temperaturen på termostaten lite grann
  • Höj värmen i vardagsrummet
  • Ställ in temperaturen på 20 till 25 grader tack.
  • Ställ in termostaten mellan 20 och 25 grader .
  • Ställ in värmen AC:n 23 grader
  • Sänk sovrummets temperatur
  • Sänk sovrums temperaturen lite grann
  • Sänk värmen i hallen med 2 grader
  • dra ner temperaturen med 2 grader
  • gör en temperatursänkning på termostaten med två grader
  • höj temperaturen 2 grader
  • höj värmen termostaten till 24 grader
  • jag vill att du höjer värmen elementen till 25 grader
  • kan du slå av uppvärmningen i vardagsrummet
  • kan du starta uppvärmning ?
  • kan du sätta på värmen ?
  • se till att höja tempen med två grader i sovrummet
  • ställ termostaten 3 grader varmare i köket
  • ställ termostaten uppvärmning
  • stäng av värmen termostaten
  • sänk temperaturen
  • sänk termostaten lite
  • sätt temperaturen på 25 grader
  • sätt termostaten 25 grader
  • vrid ner temperaturen i vardagsrummet med tre grader
  • öka värmen i arbetsrummet ordentligt

裝置錯誤:ERRORS

請參閱錯誤和例外狀況的完整清單。