Skema Atribut Pengisian Smart Home
action.devices.traits.Fill
- Sifat ini berlaku untuk perangkat yang mendukung pengisian perangkat seperti bak mandi.
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 | Type | Deskripsi |
---|---|---|
availableFillLevels |
Objek |
Menjelaskan berbagai tingkat pengisian perangkat. |
levels |
Array |
Wajib. Daftar nama level dan sinonim bahasa tertentu. |
[item, ...] |
Objek |
Nama level dan sinonim spesifik bahasanya. |
level_name |
String |
Wajib. Nama internal level. Profil ini tidak mudah digunakan dan akan dibagikan di semua bahasa. |
level_values |
Array |
Wajib. Sinonim level dalam setiap bahasa yang didukung. |
[item, ...] |
Objek |
Sinonim tingkat 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 true (benar), perangkat akan menangani tata bahasa tambahan untuk meningkatkan atau menurunkan logika, seperti yang diwakili oleh array |
supportsFillPercent |
Boolean |
(Default: Jika true (benar), terima perintah untuk menyesuaikan level ke persentase. |
Contoh
Perangkat dengan kemampuan pengisian atau pengurangan dasar yang tidak mendukung tingkat pengisian diskret.
{}
Perangkat yang mendukung tingkat pengisian diskret.
{ "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 } }
STATE Perangkat
Entitas dengan karakteristik ini dapat melaporkan status
berikut sebagai bagian dari operasi QUERY
. Untuk mempelajari
penanganan intent QUERY
lebih lanjut, lihat
fulfillment intent.
Negara bagian | Type | Deskripsi |
---|---|---|
isFilled |
Boolean |
Wajib. True jika perangkat diisi ke tingkat apa pun. False jika perangkat benar-benar terkuras habis. |
currentFillLevel |
String |
Wajib jika atribut |
currentFillPercent |
Number |
Wajib jika atribut |
Contoh
Apakah bak mandi terisi?
{ "isFilled": true }
Apakah bak mandi terisi? (dengan level).
{ "isFilled": true, "currentFillLevel": "half_level" }
PERMINTAAN 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.Fill
Isi atau buang 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 } }
Kosongkan bak mandi.
{ "command": "action.devices.commands.Fill", "params": { "fill": false } }
Isi bak mandi sampai separuh.
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "half_level" } }
Tingkatkan level pengisian bak mandi sebesar satu (perlu atribut ordered
menjadi true
).
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "full_level" } }