Skema Fitur Smart Home HumiditySetting

action.devices.traits.HumiditySetting - Trait ini digunakan untuk perangkat yang mendukung setelan kelembapan seperti pelembap udara dan pengering udara.

ATRIBUT Perangkat

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

Atribut Jenis Deskripsi
humiditySetpointRange Objek

Berisi tingkat kelembapan minimum dan maksimum sebagai persentase.

minPercent Bilangan Bulat

(Default: 0)

Mewakili tingkat kelembapan minimum sebagai persentase.

Nilai harus antara 0 dan 100.

maxPercent Bilangan Bulat

(Default: 100)

Mewakili tingkat kelembapan maksimum dalam persentase.

Nilai harus antara 0 dan 100.

commandOnlyHumiditySetting Boolean

(Default: false)

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

queryOnlyHumiditySetting Boolean

(Default: false)

Wajib jika perangkat mendukung eksekusi hanya 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 kustom.

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

STATUS Perangkat

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

Negara bagian Jenis Deskripsi
humiditySetpointPercent Bilangan Bulat

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

humidityAmbientPercent Bilangan Bulat

Menunjukkan pembacaan kelembapan sekitar saat ini pada perangkat sebagai persentase.

Nilai harus antara 1 dan 100.

Contoh

Berapa kelembapan yang ditampilkan perangkat saya?

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

PERINTAH perangkat

Perangkat dengan trait ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari lebih lanjut cara menangani intent EXECUTE, lihat Fulfillment intent.

action.devices.commands.SetHumidity

Menyetel tingkat kelembapan ke nilai mutlak.

Parameter

Parameter Jenis Deskripsi
humidity Bilangan Bulat

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

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 Jenis Deskripsi
humidityRelativePercent Bilangan Bulat

Wajib.

Nilai persentase untuk menyesuaikan tingkat kelembapan.

Nilai harus antara -100 dan 100.

Tetapkan bobot kelembapan.

Parameter Jenis Deskripsi
humidityRelativeWeight Bilangan Bulat

Wajib.

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

Nilai harus antara -5 dan 5.

Contoh

Naikkan kelembapan 10 persen

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

Menurunkan 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 ?

ERROR Perangkat

Lihat daftar lengkap error dan pengecualian.