欢迎使用 Google Home 开发者中心，这是一个学习如何开发智能家居 Action 的新平台。注意：构建 Action 的工作仍需在 Actions 控制台中完成。

智能家居温度设置特征架构

action.devices.traits.TemperatureSetting - 此特征涵盖处理温度点和模式。

设备属性

具有此特征的设备可以在 SYNC 操作中报告以下属性。如需详细了解如何处理 SYNC intent，请参阅 intent 执行方式。

属性 类型 说明
availableThermostatModes

必填。

描述此设备支持的温控器模式。
支持下列其中一项：
0 String

已弃用

此特定设备支持的一系列模式（以英文逗号分隔）。新集成应使用此属性的 Array 形式。
1 数组

此特定设备支持的模式列表。
[item, ...] String

受支持模式的名称。

支持的值：

off
已停用供暖/制冷活动
heat
设备支持供暖
cool
设备支持制冷
on
恢复设备的上一个模式。模式选择屏幕中不会显示 on 模式，因为按照设计，on 模式用于恢复设备的上一个模式。
heatcool
将供暖/制冷目标值保持在一定范围内
auto
自动模式，根据时间表或所学行为设置温度
fan-only
风扇运行时无供暖/制冷活动
purifier
净化模式
eco
节能模式
dry
除湿模式
thermostatTemperatureRange 对象

包含两个浮点值，用于表示此设备支持的温度范围（以摄氏度为单位）。
minThresholdCelsius 编号

必填。

温度范围的最小阈值。
maxThresholdCelsius 编号

必填。

温度范围的最高阈值。
thermostatTemperatureUnit String

必填。

设备默认设置的显示单位。Google 使用显示屏来报告温度信息。

支持的值：

C
F
bufferRangeCelsius 编号

（默认：2）

指定加热-冷却设置点之间的最小偏移量（以摄氏度为单位，如果支持 heatcool 模式）。
commandOnlyTemperatureSetting Boolean

（默认：false）

指示设备是否支持单向 (true) 或双向 (false) 通信。如果设备无法响应此特征的 QUERY intent 或报告状态，请将此属性设为 true。
queryOnlyTemperatureSetting Boolean

（默认：false）

如果设备支持仅执行查询，则必须提供。此属性指示设备是否只能查询状态信息，且无法控制。

示例

支持离散供暖和制冷的温控器设备

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

仅命令的温控器设备

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

设备状态

具有此特征的实体可以在 QUERY 操作中报告以下状态。如需详细了解如何处理 QUERY intent，请参阅 intent 执行方式。

州 类型 说明
activeThermostatMode String

设备当前处于活动状态的模式，来自 availableThermostatModes 列表。如果当前未启用任何模式，请将其设置为 none。

支持的值：

none
无活动模式
off
已停用供暖/制冷活动
heat
设备支持供暖
cool
设备支持制冷
on
恢复设备的上一个模式。模式选择屏幕中不会显示 on 模式，因为按照设计，on 模式用于恢复设备的上一个模式。
heatcool
将供暖/制冷目标值保持在一定范围内
auto
自动模式，根据时间表或所学行为设置温度
fan-only
风扇运行时无供暖/制冷活动
purifier
净化模式
eco
节能模式
dry
除湿模式
targetTempReachedEstimateUnixTimestampSec 整数

时间戳，表示将达到的目标温度。
thermostatHumidityAmbient 编号

表示环境湿度的相对级别（如果设备支持）。
包含下列某一项：
0 对象

固定设置点的状态。
thermostatMode String

必填。

设备当前模式，来自 availableThermostatModes 列表。

支持的值：

off
已停用供暖/制冷活动
heat
设备支持供暖
cool
设备支持制冷
on
恢复设备的先前模式
heatcool
将供暖/制冷目标值保持在一定范围内
auto
自动模式，根据时间表或所学行为设置温度
fan-only
风扇运行时无供暖/制冷活动
purifier
净化模式
eco
节能模式
dry
除湿模式
thermostatTemperatureAmbient 编号

必填。

当前观察到的温度（以摄氏度为单位）。
thermostatTemperatureSetpoint 编号

必填。

当前温度设置点（单个目标），以摄氏度为单位。
1 对象

设定的点范围的状态。
thermostatMode String

必填。

设备当前模式，来自 availableThermostatModes 列表。

支持的值：

off
已停用供暖/制冷活动
heat
设备支持供暖
cool
设备支持制冷
on
恢复设备的先前模式
heatcool
将供暖/制冷目标值保持在一定范围内
auto
自动模式，根据时间表或所学行为设置温度
fan-only
风扇运行时无供暖/制冷活动
purifier
净化模式
eco
节能模式
dry
除湿模式
thermostatTemperatureAmbient 编号

必填。

当前观察到的温度（以摄氏度为单位）。
thermostatTemperatureSetpointHigh 编号

必填。

范围中的当前最高值（如果处于 heatcool 模式）。
thermostatTemperatureSetpointLow 编号

必填。

范围中的当前最低值（如果处于 heatcool 模式）。

示例

目前的设备温度是多少？

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

目前的设备温度是多少？

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

设备命令

具有此特征的设备可能会在 EXECUTE 操作中响应以下命令。如需详细了解如何处理 EXECUTE intent，请参阅 intent 执行方式。

action.devices.commands.ThermostatTemperatureSetpoint

为温控器设备设置目标温度。

参数

参数 类型 说明
thermostatTemperatureSetpoint 编号

必填。

目标温度设定值。最多支持一位小数。

示例

将设备温度设为 22 度。

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

设置目标温度时出错。

支持的值：

alreadyAtMax
alreadyAtMin
targetAlreadyReached
valueOutOfRange

action.devices.commands.ThermostatTemperatureSetRange

为温控器设备设置目标温度范围。

此命令需要以下属性： 
{
  "availableThermostatModes": [
    "heatcool"
  ]
}

参数

参数 类型 说明
thermostatTemperatureSetpointHigh 编号

必填。

范围的高目标设定值。需要支持 heatcool 模式。
thermostatTemperatureSetpointLow 编号

必填。

范围的目标值偏低。需要支持 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 编号

必填。

温度的确切变化角度（例如“调低 5 度”）。

按权重调整。

参数 类型 说明
thermostatTemperatureRelativeWeight 整数

必填。

这表示模糊度从小幅度（“略微降低”）更改为较大量（“明显变大”）的含量变化。

示例

将温度调高 5 度

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

大幅调低温度

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

调整温度时出错。

支持的值：

alreadyAtMax
alreadyAtMin
valueOutOfRange

示例话语

de-DE

  • Auf welche Temperatur ist das Thermostat im Wohnzimmer eingestellt
  • Auf welchem Modus steht das Thermostat ?
  • Heizmodus anmachen
  • Ist der Kühlmodus an?
  • 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
  • Welche Temperatur zeigt das Thermostat an
  • 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
  • current thermostat temperature setting
  • increase the temperature on the thermostat
  • is the heating on
  • 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
  • tell me the thermostat temperature reading
  • 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
  • what mode is the thermostat

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
  • a cuántos grados tengo puesto el aire en el salón
  • 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
  • dime si el salón está en modo frío
  • 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
  • qué modo tengo puesto en el aire
  • qué temperatura hace en el salón
  • 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 .
  • Est-ce que le mode froid est allumé ?
  • 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
  • le thermostat est réglé sur combien
  • 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
  • quel est le mode du thermostat ?
  • quelle est la température du 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 .
  • a quanto è il termostato
  • a quanto è impostato il termostato
  • 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
  • su che modalità è impostato il riscaldamento in camera ?
  • voglio l'aria condizionata settata su eco
  • è accesa la modalità 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
  • Op welke instelling staat de thermostaat
  • Staat de koeling aan
  • Stel warmtemodus op de thermostaat in op 24 graden
  • Wat is de huidige instelling van de thermostaat
  • 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
  • wat is de temperatuur op de thermostaat
  • zet de koeling op de thermostaat op 16 graden
  • zet de koelstand op de thermostaat uit
  • zet de temperatuur op 25 graden
  • zet de verwarmingsstand uit
  • zet warmtemodus op 20 graden

pt-BR

  • A que temperatura está definido o termostato ?
  • A que temperatura está o termostato ?
  • 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 .
  • Qual é a temperatura do termostato ?
  • 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
  • como o escritório está ajustado?
  • desativar o modo aquecimento do termostato
  • desativar o modo refrescar
  • diminuir cinco graus a temperatura do escritório
  • diminuir o termostato
  • qual a temperatura definida no termostato ?
  • qual é o status do termostato ?
  • quero diminuir um pouco o termostato

sv-SE

  • Dra upp temperaturen på termostaten
  • Dra upp temperaturen på termostaten lite grann
  • Hur varmt är det i vardagsrummet ?
  • 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 på AC:n på 23 grader
  • Sänk sovrummets temperatur
  • Sänk sovrums temperaturen lite grann
  • Sänk värmen i hallen med 2 grader
  • Vad står termostaten på?
  • 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 på termostaten till 24 grader
  • jag vill att du höjer värmen på 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 på 3 grader varmare i köket
  • ställ termostaten på uppvärmning
  • stäng av värmen på termostaten
  • sänk temperaturen
  • sänk termostaten lite
  • sätt temperaturen på 25 grader
  • sätt termostaten på 25 grader
  • vilket läge är termostaten inställd på?
  • vrid ner temperaturen i vardagsrummet med tre grader
  • är värmen igång
  • öka värmen i arbetsrummet ordentligt

设备错误

查看错误和异常的完整列表。