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 Smart Home HumiditySetting

action.devices.traits.HumiditySetting - Sifat ini termasuk dalam perangkat yang mendukung setelan kelembapan seperti pelembap udara dan dehumidifier.

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

Berisi tingkat kelembapan minimum dan maksimum sebagai persentase.

minPercent Integer

(Default: 0)

Mewakili tingkat kelembapan minimum dalam persentase.

maxPercent Integer

(Default: 100)

Merepresentasikan tingkat kelembapan maksimum sebagai persentase.

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

queryOnlyHumiditySetting 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 yang mendukung rentang kelembapan default.

{}

Perangkat yang mendukung rentang kelembapan khusus.

{
  "humiditySetpointRange": {
    "minPercent": 25,
    "maxPercent": 75
  }
}

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
humiditySetpointPercent Integer

Menunjukkan persentase kelembapan target perangkat saat ini. Harus berada dalam humiditySetpointRange.

humidityAmbientPercent Integer

Menunjukkan tingkat kelembapan udara di perangkat saat ini yang dibaca dalam persentase.

Contoh

Kelembaban berapa yang ditampilkan perangkat saya?

{
  "humiditySetpointPercent": 20,
  "humidityAmbientPercent": 15
}

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

Setel tingkat kelembapan ke nilai absolut.

Parameter

Parameter Jenis Deskripsi
humidity Integer

Wajib.

Persentase kelembapan titik penyetelan. Harus berada dalam humiditySetpointRange.

Contoh

Setel kelembapan ke 20 persen.

{
  "command": "action.devices.commands.SetHumidity",
  "params": {
    "humidity": 20
  }
}

Terjadi error saat menyetel kelembapan target.

Nilai yang didukung:

maxSettingReached
minSettingReached
valueOutOfRange

action.devices.commands.HumidityRelative

Sesuaikan tingkat kelembapan relatif terhadap nilai saat ini.

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

Parameter

Payload berisi salah satu dari berikut ini:

Setel persen kelembapan.

Parameter Jenis Deskripsi
humidityRelativePercent Integer

Wajib.

Nilai persentase untuk menyesuaikan tingkat kelembapan.

Setel berat kelembapan.

Parameter Jenis Deskripsi
humidityRelativeWeight Integer

Wajib.

Menunjukkan jumlah kelembapan ambigu yang berubah dari sejumlah kecil ("sedikit") menjadi jumlah besar ("banyak").

Contoh

Meningkatkan kelembapan 10 persen

{
  "command": "action.devices.commands.HumidityRelative",
  "params": {
    "humidityRelativePercent": 10
  }
}

Kurangi kelembapan banyak

{
  "command": "action.devices.commands.HumidityRelative",
  "params": {
    "humidityRelativeWeight": -5
  }
}

Terjadi error saat menyesuaikan kelembapan.

Nilai yang didukung:

maxSettingReached
minSettingReached
valueOutOfRange

KESALAHAN perangkat

Lihat daftar lengkap error dan pengecualian.