Panduan Pengisi Daya Smart Home
action.devices.types.CHARGER
- Interaksi dengan pengisi daya dapat mencakup memulai dan menghentikan pengisian daya, serta memeriksa tingkat pengisian daya saat ini, kapasitas yang tersisa, dan kapasitas hingga nilai penuh.
Jenis ini menunjukkan bahwa perangkat mendapatkan ikon Pengisi Daya dan beberapa alias dan alias yang terkait.
Kemampuan perangkat
Lihat dokumentasi karakteristik yang sesuai untuk detail penerapan, seperti atribut dan status yang harus didukung oleh layanan Anda, serta cara membuat respons EXECUTE dan QUERY.
Sifat yang diperlukan
Sifat dan perintah ini diperlukan, jika berlaku untuk
perangkat Anda. Jika perangkat Anda tidak mendukung karakteristik ini, masukkan kode error functionNotSupported
dalam respons QUERY atau EXECUTE. Lihat Error dan pengecualian untuk mengetahui info selengkapnya.
Persyaratan kualitas
- Latensi: harus kurang dari atau sama dengan 800 md.
- Keandalan: harus lebih dari atau sama dengan 97%.
Contoh perangkat: Pengisi daya sederhana
Bagian ini berisi contoh payload intent yang merepresentasikan "Charger" umum berdasarkan jenis dan karakteristik perangkat di atas. Jika Anda menambahkan atau menghapus fitur dalam penerapan, ubah respons Anda untuk mencerminkan perubahan tersebut.
Contoh respons SYNC
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.CHARGER", "traits": [ "action.devices.traits.EnergyStorage" ], "name": { "name": "Simple charger" }, "willReportState": true, "attributes": { "isRechargeable": true, "queryOnlyEnergyStorage": false }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Contoh respons QUERY
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "descriptiveCapacityRemaining": "MEDIUM", "capacityRemaining": [ { "unit": "PERCENTAGE", "rawValue": 50 } ], "capacityUntilFull": [ { "unit": "SECONDS", "rawValue": 3600 } ], "isCharging": true } } } }
Contoh perintah EXECUTE
Pengisian Daya
Untuk detail tambahan tentang parameter perintah,
lihat referensi
action.devices.traits.EnergyStorage
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.Charge", "params": { "charge": false } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "capacityRemaining": [ { "unit": "PERCENTAGE", "rawValue": 50 } ], "isCharging": false } } ] } }