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 Atribut 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 fulfillment intent.

Atribut Jenis Deskripsi
availableThermostatModes

Wajib.

Menjelaskan mode termostat yang dapat didukung perangkat ini.

Mendukung salah satu dari berikut ini:
0 String

Tidak digunakan lagi

Daftar mode yang dipisahkan koma yang didukung oleh perangkat 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 pendingin
on
Pulihkan mode perangkat sebelumnya. Mode on tidak muncul di layar pemilihan mode karena mode on, berdasarkan desainnya, digunakan untuk memulihkan mode perangkat sebelumnya.
heatcool
Mempertahankan target penghangat/penyejuk sebagai rentang
auto
Mode otomatis dengan suhu yang disetel berdasarkan jadwal atau perilaku yang dipelajari
fan-only
Kipas dijalankan 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 disetel secara default. Google melaporkan informasi suhu menggunakan unit display.

Nilai yang didukung:

C
F
bufferRangeCelsius Number

(Default: 2)

Menentukan offset minimum antara titik penyetelan panas-sejuk 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 fitur ini.

queryOnlyTemperatureSetting Boolean

(Default: false)

Diperlukan jika perangkat mendukung eksekusi khusus kueri. Atribut ini menunjukkan apakah perangkat hanya dapat dikueri untuk mengetahui 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 fulfillment intent.

Negara bagian Jenis Deskripsi
activeThermostatMode String

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

Nilai yang didukung:

none
Tidak ada mode aktif
off
Aktivitas Pemanasan/Pendinginan dinonaktifkan
heat
Perangkat mendukung penghangat
cool
Perangkat mendukung pendingin
on
Pulihkan mode perangkat sebelumnya. Mode on tidak muncul di layar pemilihan mode karena mode on, berdasarkan desainnya, digunakan untuk memulihkan mode perangkat sebelumnya.
heatcool
Mempertahankan target penghangat/penyejuk sebagai rentang
auto
Mode otomatis dengan suhu yang disetel berdasarkan jadwal atau perilaku yang dipelajari
fan-only
Kipas dijalankan 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

Menyatakan tingkat relatif kelembapan sekitar, jika didukung oleh perangkat.

Berisi salah satu dari 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 pendingin
on
Pulihkan mode perangkat sebelumnya
heatcool
Mempertahankan target penghangat/penyejuk sebagai rentang
auto
Mode otomatis dengan suhu yang disetel berdasarkan jadwal atau perilaku yang dipelajari
fan-only
Kipas dijalankan 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.

Titik penyetelan suhu saat ini (satu target), dalam derajat Celsius.

1 Objek

Status untuk rentang titik penyetelan.

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 pendingin
on
Pulihkan mode perangkat sebelumnya
heatcool
Mempertahankan target penghangat/penyejuk sebagai rentang
auto
Mode otomatis dengan suhu yang disetel berdasarkan jadwal atau perilaku yang dipelajari
fan-only
Kipas dijalankan 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
}

COMMAND Perangkat

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

action.devices.commands.ThermostatTemperatureSetpoint

Menyetel suhu target untuk perangkat termostat.

Parameter

Parameter Jenis Deskripsi
thermostatTemperatureSetpoint Number

Wajib.

Titik penyetelan 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

Tetapkan 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 tersebut. 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 error saat menetapkan rentang target.

Nilai yang didukung:

alreadyAtMax
alreadyAtMin
lockedToRange
rangeTooClose
targetAlreadyReached
valueOutOfRange

action.devices.commands.ThermostatSetMode

Setel 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 pendingin
on
Pulihkan mode perangkat sebelumnya
heatcool
Mempertahankan target penghangat/penyejuk sebagai rentang
auto
Mode otomatis dengan suhu yang disetel berdasarkan jadwal atau perilaku yang dipelajari
fan-only
Kipas dijalankan 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 hal berikut:

Sesuaikan menurut derajat.

Parameter Jenis Deskripsi
thermostatTemperatureRelativeDegree Number

Wajib.

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

Sesuaikan berdasarkan berat.

Parameter Jenis Deskripsi
thermostatTemperatureRelativeWeight Integer

Wajib.

Ini menunjukkan jumlah perubahan suhu yang ambigu dari sedikit ("Kurangi sedikit"), menjadi jumlah yang besar ("Banyak yang lebih hangat").

Contoh

Menaikkan suhu 5 derajat

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

Turunkan suhu secara signifikan

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

Terjadi error 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
  • Suhu auf 20 bis 25 Grad einstellen.
  • Thermostat auf 20 bis 25 Lulus stellen.
  • Thermostat im Schlafzimmer kälter stellen
  • Wohnzimmer auf Kühlen umstellen
  • bitte dreh das Thermostat ein bisschen herunter
  • bitte dreh das Thermostat et höher
  • bitte mach es im Wohnzimmer kühler
  • bitte mach es di der Küche et 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 Suhu im Schlafzimmer auf 20 Grad
  • dreh das Thermostat wärmer bitte
  • dreh die Temperatur im Schlafzimmer et nach oben
  • dreh die Suhu um 5 Grad runner
  • erhöhe bitte die Suhu im Buruk
  • erhöhe die Temperatur um 2 Lulus
  • mach es im Wohnzimmer 2 Lulus wärmer
  • senke die Suhu im Wohnzimmer um 5 Gradasi
  • 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 mode panas.
  • ubah termostat pemanas panas antara 70 dan 80
  • ubah ke mode eco
  • Mendinginkan ruangan di ruang keluarga
  • sejuk rumah sedikit
  • naikkan suhu pada termostat
  • pertahankan termostat panas di 78
  • membuatnya 2 derajat lebih hangat
  • Buat lebih sejuk dengan 2 derajat
  • buat termostat lebih hangat sedikit
  • nyalakan penyejuk mode
  • taruh termostat aktif keren
  • naikkan suhu bawah sebesar 2 derajat
  • naikkan suhu pada termostat sebesar 5 derajat
  • setel 70 derajat aktif termostat
  • setel panaskan dingin ke mode antara 62 dan 79 derajat
  • setel suhu saya 80 derajat
  • setel panas ke 72
  • setel suhu ke keren di 70
  • setel termostat di 70 dalam keren mode
  • turunkan 5 derajat aktif termostat
  • turunkan ruang keluarga suhu 2 derajat
  • nonaktifkan termostat pemanas mode
  • putar termostat sedikit lebih rendah
  • putar termostat lebih rendah
  • pemanas ruangan ruang keluarga
  • penghangatkan ruang keluarga sedikit

es-ES

  • 25 grados de frío en la cocina
  • Ajustar el menargeto Nama penerima 21 tahun 26 tahun
  • Ajustar la temperatura termasuk 21 y 27 derajat
  • actionivar el modo calefactción
  • apagar el aire acondicionado del termostato
  • aumenta 10 gradasi 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 gradasi el modo kalori
  • saya gustaría ajustar el menargeto del salón a 25 tahap con la calefactción
  • pon a 20 gradasi la temperatura
  • pon en modo calefactción el menargeto 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 warna
  • quiero el modo aire acondicionado a 25 warna
  • quitar el modo frío del baño
  • sube 5 lulusan en la cocina
  • sube la calefactción
  • súbeme el menargeto del salón un poquito
  • súbeme más la temperatura 10 gradasi

fr-FR

  • Mode lisensi Allumer chaud .
  • Metrik en Mode chaud .
  • Mets la température ENTre 21 et 23 degrés .
  • Mets la température à 17 derajat .
  • Mest le mode froid du termostat à 19 derajat .
  • Mettre le mode froid à 19 derajat .
  • Pengukur termostat entre 70 et 80 degrés .
  • Mode Rele Lever chaud du thermostat à 22 derajat .
  • Mode Releer le chaud à 22 derajat .
  • augmented la température de 2 derajat
  • augmente un peu la température dans la chambre
  • baisse la température de la chambre
  • baisse termostat
  • baisse un peu la température dans makanan ala
  • baisse un peu termostat
  • baisser termostat de 5 deteré
  • mode coupe le chaud
  • menurun la température de 3 derajat
  • désactiver le mode frais du termostat
  • terpenuhi termostat en mode frais
  • terpenuhi termostat à 10 derajat
  • meteran 2 derajat de moins dans masak ala
  • monte la température de la chambre
  • monte la température de la salle de bain de 3 derajat
  • monte leher termostat
  • monte termostat de 2 deteré
  • monte un peu le termostat
  • Éteins le mode chaud du termostat .

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.