Selamat datang di Pusat Developer Google Home, tujuan baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Skema Trait Pengaturan Suhu Smart Home

action.devices.traits.TemperatureSetting - Sifat ini mencakup penanganan titik suhu dan mode.

ATRIBUT Perangkat

Perangkat dengan karakteristik ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari penanganan intent SYNC lebih lanjut, lihat Penjelasan intent.

Atribut Jenis Deskripsi
availableThermostatModes

Wajib.

Menjelaskan mode termostat yang dapat didukung perangkat ini.

Mendukung salah satu dari hal berikut:
0 String

Tidak digunakan lagi

Daftar mode yang dipisahkan koma yang didukung oleh perangkat khusus ini. Integrasi baru harus menggunakan bentuk Array atribut ini.

1 Array

Daftar mode yang didukung oleh perangkat ini.

[item, ...] String

Nama mode yang didukung.

Nilai yang didukung:

off
Aktivitas Pemanasan/ Pendinginan dinonaktifkan
heat
Perangkat mendukung penghangat
cool
Perangkat mendukung pendinginan
on
Memulihkan mode perangkat sebelumnya. Mode on tidak muncul di layar pemilihan mode karena secara default mode on digunakan untuk memulihkan mode perangkat sebelumnya.
heatcool
Mempertahankan target penghangat/penyejuk sebagai rentang
auto
Mode otomatis dengan suhu yang disetel berdasarkan perilaku atau jadwal yang dipelajari
fan-only
Kipas berjalan tanpa aktivitas panas/sejuk
purifier
Mode pembersihan
eco
Mode hemat energi
dry
Mode kering
thermostatTemperatureRange Objek

Berisi dua nilai float yang menunjukkan rentang suhu yang didukung untuk perangkat ini (dalam derajat Celsius).

minThresholdCelsius Number

Wajib.

Ambang batas minimum rentang suhu.

maxThresholdCelsius Number

Wajib.

Ambang batas maksimum rentang suhu.

thermostatTemperatureUnit String

Wajib.

Unit tampilan tempat perangkat ditetapkan secara default. Google melaporkan informasi suhu menggunakan satuan tampilan.

Nilai yang didukung:

C
F
bufferRangeCelsius Number

(Default: 2)

Menentukan offset minimum antara titik penyetelan pendingin panas dalam derajat Celsius, jika mode heatcool didukung.

commandOnlyTemperatureSetting Boolean

(Default: false)

Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (benar) atau dua arah (salah). Tetapkan atribut ini ke true jika perangkat tidak dapat merespons intent QUERY atau Status Laporan untuk karakteristik ini.

queryOnlyTemperatureSetting Boolean

(Default: false)

Wajib jika perangkat mendukung eksekusi khusus kueri. Atribut ini menunjukkan apakah perangkat hanya dapat dikueri untuk informasi status, dan tidak dapat dikontrol.

Contoh

Perangkat termostat yang mendukung pemanasan dan pendinginan terpisah

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

Perangkat termostat khusus perintah

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

STATUS Perangkat

Perangkat dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari penanganan intent QUERY lebih lanjut, lihat Penjelasan intent.

Negara bagian Jenis Deskripsi
activeThermostatMode String

Mode perangkat saat ini aktif, dari daftar availableThermostatModes. Jika tidak ada mode yang aktif saat ini, setel ke none.

Nilai yang didukung:

none
Tidak ada mode aktif
off
Aktivitas Pemanasan/ Pendinginan dinonaktifkan
heat
Perangkat mendukung penghangat
cool
Perangkat mendukung pendinginan
on
Memulihkan mode perangkat sebelumnya. Mode on tidak muncul di layar pemilihan mode karena secara default mode on digunakan untuk memulihkan mode perangkat sebelumnya.
heatcool
Mempertahankan target penghangat/penyejuk sebagai rentang
auto
Mode otomatis dengan suhu yang disetel berdasarkan perilaku atau jadwal yang dipelajari
fan-only
Kipas berjalan tanpa aktivitas panas/sejuk
purifier
Mode pembersihan
eco
Mode hemat energi
dry
Mode kering
targetTempReachedEstimateUnixTimestampSec Integer

Stempel waktu yang menunjukkan perkiraan waktu saat suhu target akan tercapai.

thermostatHumidityAmbient Number

Mewakili tingkat relatif kelembapan sekitar, jika didukung oleh perangkat.

Berisi salah satu item berikut:
0 Objek

Status untuk titik penyetelan tetap.

thermostatMode String

Wajib.

Mode perangkat saat ini, dari daftar availableThermostatModes.

Nilai yang didukung:

none
Tidak ada mode aktif
off
Aktivitas Pemanasan/ Pendinginan dinonaktifkan
heat
Perangkat mendukung penghangat
cool
Perangkat mendukung pendinginan
on
Memulihkan mode perangkat sebelumnya
heatcool
Mempertahankan target penghangat/penyejuk sebagai rentang
auto
Mode otomatis dengan suhu yang disetel berdasarkan perilaku atau jadwal yang dipelajari
fan-only
Kipas berjalan tanpa aktivitas panas/sejuk
purifier
Mode pembersihan
eco
Mode hemat energi
dry
Mode kering
thermostatTemperatureAmbient Number

Wajib.

Suhu yang diamati saat ini, dalam derajat Celsius.

thermostatTemperatureSetpoint Number

Wajib.

Suhu yang disetel saat ini (satu target), dalam derajat Celsius.

1 Objek

Status untuk rentang titik yang ditetapkan.

thermostatMode String

Wajib.

Mode perangkat saat ini, dari daftar availableThermostatModes.

Nilai yang didukung:

none
Tidak ada mode aktif
off
Aktivitas Pemanasan/ Pendinginan dinonaktifkan
heat
Perangkat mendukung penghangat
cool
Perangkat mendukung pendinginan
on
Memulihkan mode perangkat sebelumnya
heatcool
Mempertahankan target penghangat/penyejuk sebagai rentang
auto
Mode otomatis dengan suhu yang disetel berdasarkan perilaku atau jadwal yang dipelajari
fan-only
Kipas berjalan tanpa aktivitas panas/sejuk
purifier
Mode pembersihan
eco
Mode hemat energi
dry
Mode kering
thermostatTemperatureAmbient Number

Wajib.

Suhu yang diamati saat ini, dalam derajat Celsius.

thermostatTemperatureSetpointHigh Number

Wajib.

Titik tinggi saat ini jika dalam mode heatcool, untuk rentang.

thermostatTemperatureSetpointLow Number

Wajib.

Titik rendah saat ini jika dalam mode heatcool, untuk rentang.

Contoh

Berapa suhu perangkat saat ini?

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

Berapa suhu perangkat saat ini?

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

PERMINTAAN Perangkat

Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari penanganan intent EXECUTE lebih lanjut, lihat Penjelasan intent.

action.devices.commands.ThermostatTemperatureSetpoint

Menyetel suhu target untuk perangkat termostat.

Parameter

Parameter Jenis Deskripsi
thermostatTemperatureSetpoint Number

Wajib.

Target titik suhu target. Mendukung hingga satu angka di belakang koma.

Contoh

Setel suhu perangkat ke 22 derajat.

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

Terjadi error saat menyetel suhu target.

Nilai yang didukung:

alreadyAtMax
alreadyAtMin
targetAlreadyReached
valueOutOfRange

action.devices.commands.ThermostatTemperatureSetRange

Menyetel rentang suhu target untuk perangkat termostat.

Perintah ini memerlukan atribut berikut:
{
  "availableThermostatModes": [
    "heatcool"
  ]
}

Parameter

Parameter Jenis Deskripsi
thermostatTemperatureSetpointHigh Number

Wajib.

Setpoint target tinggi untuk rentang. Memerlukan dukungan mode heatcool.

thermostatTemperatureSetpointLow Number

Wajib.

Setpoint target rendah untuk rentang. Memerlukan dukungan mode heatcool.

Contoh

Pertahankan suhu antara 22 dan 26 derajat.

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

Terjadi kesalahan saat menetapkan rentang target.

Nilai yang didukung:

alreadyAtMax
alreadyAtMin
lockedToRange
rangeTooClose
targetAlreadyReached
valueOutOfRange

action.devices.commands.ThermostatSetMode

Menyetel mode operasi target untuk perangkat termostat.

Parameter

Parameter Jenis Deskripsi
thermostatMode String

Wajib.

Mode target, dari daftar availableThermostatModes.

Nilai yang didukung:

off
Aktivitas Pemanasan/ Pendinginan dinonaktifkan
heat
Perangkat mendukung penghangat
cool
Perangkat mendukung pendinginan
on
Memulihkan mode perangkat sebelumnya
heatcool
Mempertahankan target penghangat/penyejuk sebagai rentang
auto
Mode otomatis dengan suhu yang disetel berdasarkan perilaku atau jadwal yang dipelajari
fan-only
Kipas berjalan tanpa aktivitas panas/sejuk
purifier
Mode pembersihan
eco
Mode hemat energi
dry
Mode kering

Contoh

Setel perangkat ke mode hangat.

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

Terjadi error saat menyetel mode target.

Nilai yang didukung:

inAutoMode
inAwayMode
inDryMode
inEcoMode
inFanOnlyMode
inHeatOrCool
inHumidifierMode
inOffMode
inPurifierMode

action.devices.commands.TemperatureRelative

Menyesuaikan suhu target relatif terhadap status saat ini.

Perintah ini memerlukan atribut berikut:
{
  "commandOnlyTemperatureSetting": true
}

Parameter

Payload berisi salah satu dari berikut ini:

Sesuaikan menurut derajat.

Parameter Jenis Deskripsi
thermostatTemperatureRelativeDegree Number

Wajib.

Jumlah derajat yang tepat untuk perubahan suhu (misalnya, "Turunkan 5 derajat").

Sesuaikan menurut berat.

Parameter Jenis Deskripsi
thermostatTemperatureRelativeWeight Integer

Wajib.

Ini menunjukkan jumlah perubahan suhu yang ambigu dari jumlah kecil ("Turunkan sedikit"), menjadi jumlah besar ("Sangat hangat").

Contoh

Naikkan suhu 5 derajat

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

Turunkan suhu secara signifikan

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

Terjadi kesalahan saat menyesuaikan suhu.

Nilai yang didukung:

alreadyAtMax
alreadyAtMin
valueOutOfRange

Contoh ucapan

de-DE

  • Heizmodus anmachen
  • Mach den Heizmodus aus
  • Schalt den Heizmodus vom Thermostat aus
  • Temperatur auf 20 bis 25 Grad einstellen.
  • Termostat auf 20 bis 25 Pascasarjana 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 Lulus 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 runner
  • erhöhe bitte die Temperatur im Bad
  • erhöhe die Temperatur um 2 Grad
  • mach es im Wohnzimmer 2 Lulusan 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

  • Nonaktifkan hangat mode.
  • ubah termostat panas hangat antara 70 dan 80
  • ubah ke eco mode
  • Mendinginkan badan di ruang tamu
  • dinginkan rumah sedikit
  • naikkan suhu pada termostat
  • pertahankan termostat pemanas pada 78
  • membuat 2 derajat lebih hangat
  • buat lebih sejuk dengan 2 derajat
  • membuat termostat lebih hangat sedikit
  • nyalakan pendingin mode
  • setel termostat pada keren
  • naikkan suhu bawah lantai sebesar 2 derajat
  • naikkan suhu pada termostat sebesar 5 derajat
  • setel 70 derajat pada termostat
  • setel panas hangat mode ke antara 62 dan 79 derajat
  • setel suhu saya 80 derajat
  • setel pemanasan ke 72
  • setel suhu ke keren di 70
  • setel termostat pada 70 dalam mode keren mode
  • turunkan 5 derajat pada termostat
  • turunkan ruang tamu suhu 2 derajat
  • matikan termostat pemanas mode
  • belok termostat sedikit lebih rendah
  • belok termostat lebih rendah
  • menghangatkan ruang tamu
  • menghangatkan ruang tamu sedikit

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 calefactción
  • apagar el aire acondicionado del termostato
  • aumenta 10 grados la temperatura del horno
  • aumenta la temperatura de la cocina
  • baja algo la calefactción
  • baja la temperatura 5 gradasi
  • baja la temperatura del termostato
  • configurar el modo calefactción
  • disminuye la temperatura de la cocina un poco
  • hace demasiado calor aquí
  • saya ajustas a 25 lulusan el modo kalori
  • me gustaría ajustar el termostato del salón a 25 derajat con la calefactción
  • pon a 20 gradasi la temperatura
  • pon en modo calefactción el termostato de la cocina
  • pon la temperatura de la cocina a 20 gradasi
  • puedes subir un poco la temperatura en el salón
  • quiero bajar el nest 5 gradasi
  • quiero el modo aire acondicionado a 25 lulusan
  • quitar el modo frío del baño
  • sube 5 gradasi en la cocina
  • sube la calefactción
  • súbeme el termostato del salón un poquito
  • súbeme más la temperatura 10 grados

fr-FR

  • Mode allumer le chaud .
  • Metrik en mode chaud .
  • Mest la température entre 21 et 23 degrés .
  • Mest la température à 17 derajat .
  • Mode metrik
  • Mode meteran froid à 19 derajat .
  • Mettre le termostat entre 70 et 80 degrés .
  • Mode Régler le chaud du termostat à 22 derajat .
  • Mode Régler le chaud à 22 degrés .
  • augmented la température de 2 derajat
  • augmented un peu la température dans la chambre
  • baisse la température de la chambre
  • baisse le termostat
  • baisse un peu la température dans Masakan ala
  • baisse un peu le termostat
  • baisser le termostat de 5 derajat
  • mode coupe le chaud
  • turun la température de 3 derajat
  • désactiver le mode frais du termostat
  • memenuhi le termostat en mode frais
  • memenuhi le termostat à 10 derajat
  • metermeter 2 degrés de moins dans Masakan ala
  • monte la température de la chambre
  • monte la température de la salle de bain de 3 degrés
  • monte le termostat
  • monte le termostat de 2 derajat
  • monte un peu le termostat
  • Éteins le mode chaud du termostat .

KESALAHAN perangkat

Lihat daftar lengkap error dan pengecualian.