Panduan Ketel Smart Home
action.devices.types.KETTLE
- Ketel adalah alat untuk merebus air. Interaksi dengan teko listrik dapat mencakup pengaktifan dan penonaktifan teko listrik, menyesuaikan suhu target, dan mungkin menyesuaikan berbagai setelan mode.
Jenis ini menunjukkan bahwa perangkat mendapatkan ikon Kettle dan beberapa hal terkait sinonim dan alias.
Ketel memiliki tata bahasa berbasis jenis untukaction.devices.traits.OnOff
.
Jika perangkat mendukung OnOff
, Rebus air
akan mengirimkan perintah action.devices.commands.OnOff
.
Kemampuan perangkat
Lihat dokumentasi sifat yang sesuai untuk detail penerapan, seperti atribut dan status yang harus didukung layanan Anda, serta cara membangun respons EXECUTE dan QUERY.
Ciri yang diperlukan
Sifat dan perintah ini diperlukan, jika berlaku untuk
perangkat seluler. Jika perangkat Anda tidak mendukung ciri ini, masukkan kode kesalahan
functionNotSupported
dalam respons QUERY atau EXECUTE. Lihat
Error dan pengecualian untuk info selengkapnya.
Fitur yang direkomendasikan
Fitur ini direkomendasikan, jika berlaku untuk perangkat Anda. Namun, Anda bebas memadupadankan semua sifat yang tersedia agar cocok dengan yang ada fungsionalitas produk.
Persyaratan kualitas
- Latensi: harus kurang dari atau sama dengan 800 md.
- Keandalan: harus lebih dari atau sama dengan 97%.
Perangkat contoh: Ketel sederhana
Bagian ini berisi contoh payload intent yang mewakili "Ketel" umum berdasarkan jenis dan karakteristik perangkat di atas. Jika Anda menambahkan atau menghapus ciri khas dalam implementasi Anda, ubah tanggapan 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.KETTLE", "traits": [ "action.devices.traits.TemperatureControl", "action.devices.traits.OnOff" ], "name": { "name": "Simple kettle" }, "willReportState": true, "attributes": { "temperatureRange": { "minThresholdCelsius": 0, "maxThresholdCelsius": 100 }, "temperatureUnitForUX": "F" }, "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, "on": true, "temperatureSetpointCelsius": 100 } } } }
Contoh perintah EXECUTE
SetTemperature
Untuk detail tambahan
tentang parameter perintah,
lihat
action.devices.traits.TemperatureControl
alamat IP internal.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetTemperature", "params": { "temperature": 85 } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "temperatureSetpointCelsius": 85 } } ] } }
OnOff
Untuk detail tambahan
tentang parameter perintah,
lihat
action.devices.traits.OnOff
alamat IP internal.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }