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 Sifat Kontrol Suhu Smart Home

action.devices.traits.TemperatureControl - Sifat untuk perangkat (selain termostat) yang mendukung kontrol suhu, baik di dalam atau di sekitar perangkat.

Ini berbeda dengan fitur TemperatureSetting, yang khusus untuk kontrol bergaya termostat. Fitur TemperatureSetting mewakili suhu ruangan (ruang/outdoor) dan tidak boleh digunakan untuk mengontrol suhu perangkat tertentu. Untuk mengontrol suhu perangkat tertentu, Anda harus menggunakan fitur TemperatureControl.

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
temperatureRange Objek

Wajib.

Rentang suhu perangkat yang didukung.

minThresholdCelsius Number

Wajib.

Suhu minimum untuk rentang, dalam derajat Celsius.

maxThresholdCelsius Number

Wajib.

Suhu maksimum untuk rentang, dalam derajat Celsius.

temperatureStepCelsius Number

Menentukan langkah suhu relatif. Ini adalah interval penyesuaian minimum yang didukung perangkat. Jika tidak ditentukan, langkah relatif dihitung sebagai persentase dari temperatureRange.

temperatureUnitForUX String

Wajib.

Unit suhu yang digunakan sebagai respons terhadap pengguna.

Nilai yang didukung:

C
F
commandOnlyTemperatureControl 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.

queryOnlyTemperatureControl 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

Kontrol pendukung perangkat antara 150 hingga 500 derajat Fahrenheit, dengan kelipatan 5 derajat.

{
  "temperatureRange": {
    "minThresholdCelsius": 65.5,
    "maxThresholdCelsius": 260
  },
  "temperatureStepCelsius": 2.778,
  "temperatureUnitForUX": "F"
}

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
temperatureSetpointCelsius Number

Setpoint suhu saat ini, dalam derajat Celsius. Harus berada dalam temperatureRange. Wajib jika queryOnlyTemperatureControl ditetapkan ke false

temperatureAmbientCelsius Number

Suhu yang saat ini diamati, dalam derajat Celsius. Harus berada dalam temperatureRange.

Contoh

Berapa suhu yang disetel ke perangkat?

{
  "temperatureSetpointCelsius": 150
}

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.SetTemperature

Setel suhu ke nilai tertentu.

Parameter

Parameter Jenis Deskripsi
temperature Number

Wajib.

Suhu yang disetel, dalam derajat Celsius. Harus berada dalam temperatureRange.

Contoh

Tetapkan perangkat ke 350 derajat Fahrenheit.

{
  "command": "action.devices.commands.SetTemperature",
  "params": {
    "temperature": 176.67
  }
}

Terjadi error saat menyetel suhu target.

Nilai yang didukung:

alreadyAtMax
alreadyAtMin
valueOutOfRange

Contoh ucapan

de-DE

  • Erhöhe die Temperatur des Ofens
  • Stelle die Suhu des Ofens auf Lulusan 425

en-US

  • saya mau suhu oven lebih tinggi
  • setel oven ke 400

es-ES

  • pon la temperatura del horno a 180 gradus
  • sube la temperatura del horno

fr-FR

  • Mets la température du empat à 180 derajat .
  • augmented la température du empat

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.