Skema Trait Isi Smart Home
action.devices.traits.Fill
- Ciri ini berlaku untuk perangkat yang mendukung pengisian seperti bak mandi.
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 |
---|---|---|
availableFillLevels |
Objek |
Menjelaskan berbagai tingkat pengisian perangkat. |
levels |
Array |
Wajib. Daftar nama level dan sinonim khusus bahasa. |
[item, ...] |
Objek |
Nama level dan sinonim khusus bahasanya. |
level_name |
String |
Wajib. Nama internal level. Bagian ini mungkin tidak mudah digunakan, dan akan dibagikan dalam semua bahasa. |
level_values |
Array |
Wajib. Sinonim level dalam setiap bahasa yang didukung. |
[item, ...] |
Objek |
Sinonim level dalam bahasa tertentu. |
level_synonym |
Array |
Wajib. Sinonim tingkat. String pertama dalam daftar ini digunakan sebagai nama kanonis level dalam bahasa tersebut. |
[item, ...] |
String |
Nama sinonim. |
lang |
String |
Wajib. Kode bahasa (ISO 639-1). Lihat bahasa yang didukung. |
ordered |
Boolean |
Wajib. Jika benar, perangkat akan menangani tata bahasa tambahan untuk logika penambahan atau penurunan, seperti yang diwakili oleh array |
supportsFillPercent |
Boolean |
(Default: Jika true (benar), terima perintah untuk menyesuaikan level ke persentase. |
Contoh
Perangkat dengan kemampuan pengisian atau pembuangan dasar yang tidak mendukung tingkat pengisian terpisah.
{}
Perangkat yang mendukung tingkat pengisian terpisah.
{ "availableFillLevels": { "levels": [ { "level_name": "half_level", "level_values": [ { "level_synonym": [ "Half", "Half way", "One half" ], "lang": "en" } ] }, { "level_name": "full_level", "level_values": [ { "level_synonym": [ "Full", "All the way", "Complete" ], "lang": "en" } ] } ], "ordered": true } }
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 |
---|---|---|
isFilled |
Boolean |
Wajib. True jika perangkat diisi ke tingkat mana pun. Salah jika perangkat benar-benar habis. |
currentFillLevel |
String |
Wajib jika atribut |
currentFillPercent |
Number |
Wajib jika atribut |
Contoh
Apakah bak mandi sudah terisi?
{ "isFilled": true }
Apakah bak mandi sudah terisi? (dengan level).
{ "isFilled": true, "currentFillLevel": "half_level" }
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.Fill
Isi atau kosongkan perangkat.
Parameter
Parameter | Type | Deskripsi |
---|---|---|
fill |
Boolean |
Wajib. Benar untuk diisi, salah untuk dikosongkan. |
fillLevel |
String |
Menunjukkan |
fillPercent |
Number |
Menunjukkan persentase level yang diminta. |
Contoh
Isi bak mandi.
{ "command": "action.devices.commands.Fill", "params": { "fill": true } }
Keringkan bak mandi.
{ "command": "action.devices.commands.Fill", "params": { "fill": false } }
Isi bak mandi setengah.
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "half_level" } }
Tingkatkan level pengisian bak mandi satu (memerlukan atribut ordered
menjadi true
).
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "full_level" } }