Skema Trait Kecepatan Smart Home
action.devices.traits.FanSpeed
- Sifat ini termasuk perangkat yang mendukung penyetelan kecepatan kipas.
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 |
---|---|---|
reversible |
Boolean |
(Default: Jika disetel ke benar (true), perangkat ini akan mendukung kipas angin ke kedua arah dan dapat menerima perintah untuk membalik 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 fitur ini. |
Berisi salah satu dari 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. Link ini dapat 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 untuk 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 dari 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 penambahan atau penurunan akan diterapkan, dalam urutan (meningkatkan) 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, yang mendukung arah terbalik dan penyesuaian 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
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 |
---|---|---|
currentFanSpeedSetting |
String |
Nama ini mewakili nama internal dari setelan kecepatan saat ini dari atribut |
currentFanSpeedPercent |
Number |
Menunjukkan kecepatan kipas saat ini menurut persentase. Wajib jika atribut |
Contoh
Berapa kecepatan kipas angin di ruang tamu?
{ "currentFanSpeedSetting": "speed_low", "currentFanSpeedPercent": 10 }
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.SetFanSpeed
Setel kecepatan.
Parameter
Payload berisi salah satu dari hal berikut:
Menyetel 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
Setel kipas ke tinggi.
{ "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeed": "speed_high" } }
Setel 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 dari hal berikut:
Tetapkan kecepatan relatif berdasarkan berat.
Parameter | Jenis | Deskripsi |
---|---|---|
fanSpeedRelativeWeight |
Integer |
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 menunjukkan persentase kecepatan untuk berubah. |
Contoh
Turunkan kecepatan kipas angin.
{ "command": "action.devices.commands.SetFanSpeedRelative", "params": { "fanSpeedRelativeWeight": -1 } }
Tingkatkan kecepatan kipas 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
Arah ke arah kipas.
{ "command": "action.devices.commands.Reverse", "params": {} }
Contoh ucapan
de-DE
-
stell die Geschwindigkeit
vom Ventilator aufhoch
en-US
-
drop
the AC fan speed tomedium
es-ES
-
cambia la velocidad del
ventilador amedio
fr-FR
-
mets
la ventilation aumaximum
hi-IN
-
बेडरूम में पंखे
की गति
मीडियम करें
it-IT
-
metti
il condizionatore in salotto a velocitàmedia
ja-JP
-
エアコン の風量を高速 にセット
ko-KR
-
선풍기 강풍 으로 틀어 줘
nl-NL
-
zet de snelheid van
de ventilator opmedium
pt-BR
-
definir a velocidade do
ventilador parabaixa -
põe
a ventoinha nomá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.