Skema Atribut EnergyStorage Smart Home
action.devices.traits.EnergyStorage
- Sifat ini termasuk perangkat yang dapat menyimpan energi di baterai dan mungkin dapat diisi ulang, atau yang dapat mengisi daya perangkat lain.
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 |
---|---|---|
queryOnlyEnergyStorage |
Boolean |
Wajib. Berlaku jika perangkat ini hanya mendukung kueri tentang level energi yang disimpan dan, secara opsional, status pengisian daya aktif (bergantung pada atribut |
energyStorageDistanceUnitForUX |
String |
(Default: Akan digunakan sebagai respons terhadap pengguna. Nilai yang didukung:
|
isRechargeable |
Boolean |
(Default: Tetapkan ke true jika perangkat ini dapat diisi ulang. Hal ini menunjukkan bahwa perangkat dapat melaporkan status |
Contoh
Perangkat yang dapat diisi ulang
{ "isRechargeable": true, "queryOnlyEnergyStorage": false }
Perangkat yang dapat diisi ulang dan menampilkan level pengisian daya saat ini dalam mil
{ "isRechargeable": true, "energyStorageDistanceUnitForUX": "MILES", "queryOnlyEnergyStorage": false }
Perangkat yang tidak dapat diisi ulang dan hanya mendukung pelaporan tingkat pengisian daya saat ini
{ "isRechargeable": false, "queryOnlyEnergyStorage": 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 |
---|---|---|
descriptiveCapacityRemaining |
String |
Wajib. Deskripsi kualitatif tingkat kapasitas energi. Perhatikan bahwa hal ini dilakukan saat tidak ada data kapasitas numerik. Jika data kapasitas numerik juga tersedia, data tersebut akan lebih diutamakan daripada deskriptif jika memungkinkan. Nilai yang didukung:
|
capacityRemaining |
Array |
Array pasangan unit/nilai yang menyimpan informasi tentang kapasitas energi yang saat ini dimiliki perangkat. Misalnya: Berapa mil yang dimiliki <device> saya saat ini atau Berapa persentase biaya yang dimiliki <device> saya |
[item, ...] |
Objek |
Kapasitas yang tersisa dalam pasangan unit dan nilai. |
rawValue |
Integer |
Wajib. Nilai kapasitas. |
unit |
String |
Wajib. Unit kapasitas. Nilai yang didukung:
|
capacityUntilFull |
Array |
Array pasangan unit/nilai yang menyimpan informasi tentang kapasitas hingga perangkat terisi penuh. Misalnya: Berapa lama waktu yang diperlukan hingga <device> terisi penuh dayanya. |
[item, ...] |
Objek |
Kapasitas hingga terisi daya. |
rawValue |
Integer |
Wajib. Nilai kapasitas. |
unit |
String |
Wajib. Unit kapasitas. Nilai yang didukung:
|
isCharging |
Boolean |
Apakah perangkat sedang mengisi daya. |
isPluggedIn |
Boolean |
Apakah perangkat saat ini dicolokkan. Perangkat dapat dicolokkan, tetapi tidak mengisi daya secara aktif. |
Contoh
Perangkat yang dapat diisi ulang
{ "descriptiveCapacityRemaining": "HIGH", "capacityRemaining": [ { "rawValue": 36000, "unit": "SECONDS" }, { "rawValue": 90, "unit": "PERCENTAGE" } ], "capacityUntilFull": [ { "rawValue": 120, "unit": "SECONDS" } ], "isCharging": true, "isPluggedIn": true }
Perangkat yang dapat diisi ulang dan menampilkan level pengisian daya saat ini dalam mil
{ "descriptiveCapacityRemaining": "CRITICALLY_LOW", "capacityRemaining": [ { "rawValue": 12, "unit": "MILES" } ], "capacityUntilFull": [ { "rawValue": 6000, "unit": "SECONDS" } ], "isCharging": true, "isPluggedIn": true }
Perangkat yang tidak dapat diisi ulang dan hanya mendukung pelaporan tingkat pengisian daya saat ini
{ "descriptiveCapacityRemaining": "LOW" }
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.Charge
Mulai atau hentikan pengisian daya.
Perintah ini memerlukan atribut berikut:{ "isRechargeable": true }
Parameter
Parameter | Jenis | Deskripsi |
---|---|---|
charge |
Boolean |
Wajib. Benar untuk mulai mengisi daya, salah untuk menghentikan pengisian daya. |
Contoh
Mulai menjalankan perintah pengisian daya
{ "command": "action.devices.commands.Charge", "params": { "charge": true } }
Menghentikan perintah pengisian daya
{ "command": "action.devices.commands.Charge", "params": { "charge": false } }
Perangkat ERRORS
Lihat daftar lengkap error dan pengecualian.deviceUnplugged
: Pengguna mencoba mengisi daya perangkat yang tidak dicolokkan.