Panduan Atap Teras Smart Home
action.devices.types.AWNING
- Peneduh dapat ditarik dan dapat dibuka serta ditutup. Perangkat ini dapat dipasang di dalam atau di luar ruangan.
Jenis ini menunjukkan bahwa perangkat mendapatkan ikon Awning serta beberapa sinonim dan alias yang terkait.
Kemampuan perangkat
Lihat dokumentasi fitur yang sesuai untuk detail penerapan, seperti atribut dan status yang harus didukung layanan Anda, serta cara membuat respons EXECUTE dan QUERY.
Trait yang diperlukan
Sifat dan perintah ini diperlukan, jika berlaku untuk perangkat
Anda. Jika perangkat tidak mendukung fitur ini, masukkan kode error
functionNotSupported
dalam respons QUERY atau EXECUTE. Lihat Error dan pengecualian untuk info selengkapnya.
Persyaratan kualitas
- Latensi: harus kurang dari atau sama dengan 2500 md.
- Keandalan: harus lebih dari atau sama dengan 97%.
Contoh perangkat: Kerai sederhana
Bagian ini berisi contoh payload intent yang merepresentasikan "Awning" umum berdasarkan jenis dan karakteristik perangkat di atas. Jika Anda menambahkan atau menghapus trait dalam implementasi Anda, ubah respons tersebut agar 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.AWNING", "traits": [ "action.devices.traits.OpenClose" ], "name": { "name": "Simple awning" }, "willReportState": true, "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, "openPercent": 50 } } } }
Contoh perintah EXECUTE
OpenClose
Untuk detail tambahan tentang parameter perintah,
lihat referensi
action.devices.traits.OpenClose
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OpenClose", "params": { "openPercent": 100 } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "openPercent": 100 } } ] } }