Panduan Smart Home Scene
action.devices.types.SCENE
- Pada kasus scene, jenis memetakan 1:1 ke karakteristik, karena scene tidak digabungkan dengan karakteristik lain untuk membentuk perangkat gabungan. Suasana harus selalu memiliki nama yang disediakan pengguna. Setiap scene adalah perangkat virtualnya sendiri dengan namanya sendiri.
Jenis ini menunjukkan bahwa perangkat mendapatkan ikon Scene serta beberapa sinonim dan alias yang terkait.
Lihat Fitur scene untuk mengetahui informasi selengkapnya.
Kemampuan perangkat
Lihat dokumentasi trait yang sesuai untuk detail implementasi, seperti atribut dan status yang harus didukung layanan Anda, dan cara membuat respons EXECUTE dan QUERY.
Trait 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 info selengkapnya.
Persyaratan kualitas
- Latensi: harus kurang dari atau sama dengan 3000 md.
- Keandalan: harus lebih dari atau sama dengan 97%.
Contoh perangkat: Suasana sederhana
Bagian ini berisi contoh payload intent yang merepresentasikan "Scene" umum berdasarkan jenis dan karakteristik perangkat di atas. Jika Anda menambahkan atau menghapus karakteristik dalam implementasi, ubah respons yang sesuai 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.SCENE", "traits": [ "action.devices.traits.Scene" ], "name": { "name": "Simple scene" }, "willReportState": true, "attributes": { "sceneReversible": 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 } } } }
Contoh perintah EXECUTE
ActivateScene
Untuk detail tambahan tentang parameter perintah,
lihat referensi
action.devices.traits.Scene
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.ActivateScene", "params": { "deactivate": false } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true } } ] } }