Skema Trait Setelan Kelembapan Smart Home

action.devices.traits.HumiditySetting - Ciri ini milik perangkat yang mendukung setelan kelembapan seperti pelembap dan pengering udara.

ATTRIBUTE Perangkat

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

Atribut Type Deskripsi
humiditySetpointRange Objek

Berisi tingkat kelembapan minimum dan maksimum dalam bentuk persentase.

minPercent Bilangan Bulat

(Default: 0)

Menampilkan tingkat kelembapan minimum dalam persentase.

maxPercent Bilangan Bulat

(Default: 100)

Menampilkan tingkat kelembapan maksimum dalam persentase.

commandOnlyHumiditySetting Boolean

(Default: false)

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

queryOnlyHumiditySetting Boolean

(Default: false)

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

Contoh

Perangkat yang mendukung rentang kelembapan default.

{}

Perangkat yang mendukung rentang kelembapan kustom.

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

STATUS Perangkat

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

Status Type Deskripsi
humiditySetpointPercent Bilangan Bulat

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

humidityAmbientPercent Bilangan Bulat

Menunjukkan pembacaan kelembapan sekitar saat ini dari perangkat dalam persentase.

Contoh

Kelembapan apa yang ditampilkan perangkat saya?

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

Perangkat COMMAND

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

Setel tingkat kelembapan ke nilai absolut.

Parameter

Parameter Type Deskripsi
humidity Bilangan Bulat

Wajib.

Persentase kelembapan titik penyetelan. Harus 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

Menyesuaikan tingkat kelembapan relatif terhadap nilai saat ini.

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

Parameter

Payload berisi salah satu hal berikut:

Setel persentase kelembapan.

Parameter Type Deskripsi
humidityRelativePercent Bilangan Bulat

Wajib.

Nilai persentase untuk menyesuaikan tingkat kelembapan.

Menyetel berat kelembapan.

Parameter Type Deskripsi
humidityRelativeWeight Bilangan Bulat

Wajib.

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

Contoh

Tingkatkan kelembapan 10 persen

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

Mengurangi tingkat kelembapan secara signifikan

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

Terjadi error saat menyesuaikan kelembapan.

Nilai yang didukung:

maxSettingReached
minSettingReached
valueOutOfRange

Contoh ucapan

de-DE

  • Welche Luftfeuchtigkeit zeigt das Thermostat an?

en-US

  • what is the humidity upstairs

es-ES

  • cuánta humedad hay ahora en la cocina

fr-FR

  • le thermostat donne quel taux d'humidité

hi-IN

  • ह्यूमिडिटी का स्तर किचन के थर्मोस्टैट से कितना है?

it-IT

  • quanta umidità segna il termostato

ja-JP

  • サーモスタット にどれくらいの湿度ってでてる

ko-KR

  • 온도 조절계 에 습도 몇이야?

nl-NL

  • wat is de vochtigheid op de thermostaat

pt-BR

  • Qual é o nível de humidade mostrado no termostato ?
  • diga qual é a umidade relativa do ar mostrada no termostato

sv-SE

  • Vad är det för luftfuktighet i badrummet ?

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.