Skema Kecepatan Kipas Smart Home
action.devices.traits.FanSpeed
- Sifat ini milik perangkat yang mendukung penyetelan kecepatan kipas.
ATTRIBUTES Perangkat
Perangkat dengan karakteristik ini mungkin melaporkan hal berikut
sebagai bagian dari operasi SYNC
. Untuk mempelajari
selengkapnya tentang menangani intent SYNC
, lihat
Pemenuhan intent.
Atribut | Jenis | Deskripsi |
---|---|---|
reversible |
Boolean |
(Default: Jika disetel ke benar (true), perangkat ini mendukung tiupan kipas dalam dua arah dan dapat menerima perintah untuk membalikkan arah kipas. |
commandOnlyFanSpeed |
Boolean |
(Default: 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. |
Berisi salah satu item berikut: | ||
0
|
Objek |
Dukungan untuk setelan kecepatan. |
availableFanSpeeds |
Objek |
Wajib. Setelan kecepatan yang didukung oleh perangkat. |
speeds |
Array |
Wajib. Daftar setelan kecepatan. |
[item, ...] |
Objek |
Setelan kecepatan. |
speed_name |
String |
Wajib. Nama internal setelan kecepatan. URL ini mungkin tidak mudah digunakan dan akan dibagikan dalam semua bahasa. |
speed_values |
Array |
Wajib. Sinonim untuk setelan kecepatan dalam setiap bahasa yang didukung. |
[item, ...] |
Objek |
Sinonim dari setelan kecepatan dalam bahasa tertentu. |
speed_synonym |
Array |
Wajib. Sinonim untuk setelan kecepatan harus mencakup bentuk tunggal dan jamak, jika berlaku. Sinonim pertama dalam daftar akan dianggap sebagai nama kanonis setelan kecepatan. |
[item, ...] |
String |
Sinonim. |
lang |
String |
Wajib. Kode bahasa (ISO 639-1). Lihat bahasa yang didukung. |
ordered |
Boolean |
Wajib. Jika disetel ke benar (true), tata bahasa tambahan untuk logika peningkatan atau penurunan akan diterapkan, sesuai urutan (peningkatan) array kecepatan. |
1
|
Objek |
Dukungan untuk persentase kecepatan. |
supportsFanSpeedPercent |
Boolean |
Wajib. (Default: Jika disetel ke benar (true), perangkat ini akan menerima perintah untuk menyesuaikan kecepatan menggunakan persentase dari 0,0 hingga 100,0. |
Contoh
Perangkat dengan dua setelan kecepatan, mendukung penyesuaian arah mundur dan persentase.
{ "availableFanSpeeds": { "speeds": [ { "speed_name": "speed_low", "speed_values": [ { "speed_synonym": [ "Low", "Slow" ], "lang": "en" } ] }, { "speed_name": "speed_high", "speed_values": [ { "speed_synonym": [ "High", "Fast" ], "lang": "en" } ] } ], "ordered": true }, "reversible": true, "supportsFanSpeedPercent": true }
STATUS Perangkat
Entitas dengan karakteristik ini dapat melaporkan hal berikut
status sebagai bagian dari operasi QUERY
. Untuk mempelajari
selengkapnya tentang menangani intent QUERY
, lihat
Pemenuhan intent.
Negara bagian | Jenis | Deskripsi |
---|---|---|
currentFanSpeedSetting |
String |
Ini mewakili nama internal setelan kecepatan saat ini dari atribut |
currentFanSpeedPercent |
Number |
Menunjukkan kecepatan kipas saat ini berdasarkan persentase. Wajib jika atribut |
Contoh
Berapa kecepatan kipas di ruang tamu?
{ "currentFanSpeedSetting": "speed_low", "currentFanSpeedPercent": 10 }
Perangkat COMMANDS
Perangkat dengan karakteristik ini dapat merespons hal berikut
sebagai bagian dari operasi EXECUTE
. Untuk mempelajari
selengkapnya tentang menangani intent EXECUTE
, lihat
Pemenuhan intent.
action.devices.commands.SetFanSpeed
Setel kecepatan.
Parameter
Payload berisi salah satu hal berikut:
Setel kecepatan berdasarkan setelan.
Parameter | Jenis | Deskripsi |
---|---|---|
fanSpeed |
String |
Wajib. Setelan kecepatan kipas yang diminta. |
Setel kecepatan berdasarkan persentase.
Parameter | Jenis | Deskripsi |
---|---|---|
fanSpeedPercent |
Number |
Wajib. Persentase setelan kecepatan yang diminta. |
Contoh
Atur kipas ke suhu tinggi.
{ "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeed": "speed_high" } }
Atur kecerahan kipas ke 50%.
{ "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeedPercent": 50 } }
action.devices.commands.SetFanSpeedRelative
Tetapkan kecepatan relatif.
Perintah ini memerlukan atribut berikut:{ "commandOnlyFanSpeed": true }
Parameter
Payload berisi salah satu hal berikut:
Tetapkan kecepatan relatif berdasarkan berat.
Parameter | Jenis | Deskripsi |
---|---|---|
fanSpeedRelativeWeight |
Bilangan Bulat |
Wajib. Nilai ini menunjukkan jumlah relatif perubahan kecepatan. Nilai absolut menunjukkan jumlah yang diskalakan sedangkan tanda numerik menunjukkan arah perubahan. |
Tetapkan kecepatan relatif berdasarkan persentase.
Parameter | Jenis | Deskripsi |
---|---|---|
fanSpeedRelativePercent |
Number |
Wajib. Nilai ini mewakili persentase kecepatan yang berubah. |
Contoh
Turunkan kecepatan kipas sedikit.
{ "command": "action.devices.commands.SetFanSpeedRelative", "params": { "fanSpeedRelativeWeight": -1 } }
Naikkan kecepatan kipas angin sebesar 10 persen.
{ "command": "action.devices.commands.SetFanSpeedRelative", "params": { "fanSpeedRelativePercent": 10 } }
action.devices.commands.Reverse
Balik arah kipas.
Perintah ini memerlukan atribut berikut:{ "reversible": true }
Parameter
Parameter | Jenis | Deskripsi |
---|---|---|
Tidak ada properti |
Contoh
Balikkan arah kipas.
{ "command": "action.devices.commands.Reverse", "params": {} }
Contoh ucapan
de-DE
- stell die Geschwindigkeit vom Ventilator auf hoch
en-US
- drop the AC fan speed to medium
es-ES
- cambia la velocidad del ventilador a medio
fr-FR
- mets la ventilation au maximum
hi-IN
- बेडरूम में पंखे की गति मीडियम करें
it-IT
- metti il condizionatore in salotto a velocità media
ja-JP
- エアコン の風量を 高速 にセット
ko-KR
- 선풍기 강풍 으로 틀어 줘
nl-NL
- zet de snelheid van de ventilator op medium
pt-BR
- definir a velocidade do ventilador para baixa
- põe a ventoinha no máximo
sv-SE
- Ställ in fläkten på medel
Perangkat ERRORS
Lihat daftar lengkap error dan pengecualian.maxSpeedReached
: Perangkat sudah disetel ke kecepatan maksimum.minSpeedReached
: Perangkat sudah disetel ke kecepatan minimum.