Skema Trait EnergyStorage Smart Home
action.devices.traits.EnergyStorage
- Ciri ini milik perangkat yang dapat menyimpan energi dalam baterai dan berpotensi diisi ulang, atau perangkat yang dapat mengisi daya perangkat lain.
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 |
---|---|---|
queryOnlyEnergyStorage |
Boolean |
Wajib. Benar jika perangkat ini hanya mendukung kueri tentang level energi yang tersimpan dan, secara opsional, status pengisian daya aktif (bergantung pada atribut |
energyStorageDistanceUnitForUX |
String |
(Default: Akan digunakan sebagai respons kepada pengguna. Nilai yang didukung:
|
isRechargeable |
Boolean |
(Default: Setel ke true (benar) 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 yang menampilkan tingkat pengisian daya saat ini dalam mil
{ "isRechargeable": true, "energyStorageDistanceUnitForUX": "MILES", "queryOnlyEnergyStorage": false }
Perangkat yang tidak dapat diisi ulang yang hanya mendukung pelaporan tingkat pengisian daya saat ini
{ "isRechargeable": false, "queryOnlyEnergyStorage": 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 |
---|---|---|
descriptiveCapacityRemaining |
String |
Wajib. Deskripsi kualitatif tentang tingkat kapasitas energi. Perhatikan bahwa ini digunakan saat tidak ada data kapasitas numerik. Jika data kapasitas numerik juga tersedia, data itu akan lebih disukai daripada deskriptif jika memungkinkan. Nilai yang didukung:
|
capacityRemaining |
Array |
Array pasangan unit/nilai yang menyimpan informasi tentang kapasitas energi yang saat ini dipegang perangkat. Misalnya: Berapa mil yang dibutuhkan <device> saya saat ini atau Berapa persentase pengisian daya <device> saya |
[item, ...] |
Objek |
Sisa kapasitas dalam pasangan nilai dan unit. |
rawValue |
Bilangan Bulat |
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 daya penuh. Misalnya: Berapa lama waktu yang dibutuhkan hingga <device> terisi penuh. |
[item, ...] |
Objek |
Kapasitas hingga diisi daya. |
rawValue |
Bilangan Bulat |
Wajib. Nilai kapasitas. |
unit |
String |
Wajib. Unit kapasitas. Nilai yang didukung:
|
isCharging |
Boolean |
Apakah perangkat sedang diisi dayanya. |
isPluggedIn |
Boolean |
Apakah perangkat sedang dicolokkan. Perangkat dapat dicolokkan, tetapi tidak aktif mengisi daya. |
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 yang menampilkan tingkat 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 yang hanya mendukung pelaporan tingkat pengisian daya saat ini
{ "descriptiveCapacityRemaining": "LOW" }
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.Charge
Memulai atau berhenti mengisi daya.
Perintah ini memerlukan atribut berikut:{ "isRechargeable": true }
Parameter
Parameter | Type | Deskripsi |
---|---|---|
charge |
Boolean |
Wajib. Benar untuk mulai mengisi daya, salah untuk menghentikan pengisian daya. |
Contoh
Mulai 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.