Akıllı Ev Oda Spreyi
action.devices.types.AIRFRESHENER
- Oda spreyi açılabilir ve kapatılabilir ve çeşitli modların ayarlanmasına olanak tanıyabilir.
Bu tür, cihazın Hava Spresi simgesinin yanı sıra ilgili bazı eş anlamlıları ve takma adları aldığını belirtir.
Cihaz özellikleri
Hizmetinizin desteklemesi gereken özellikler ve durumlar ile EXECUTE ve QUERY yanıtlarının nasıl oluşturulacağı gibi uygulama ayrıntıları için ilgili özellik belgelerine bakın.
Gerekli özellikler
Bu özellikler ve komutlar, cihazınız için geçerliyse zorunludur. Cihazınız bu özellikleri desteklemiyorsa bir QUERY veya EXECUTE yanıtına functionNotSupported
hata kodunu girin. Daha fazla bilgi için Hatalar ve istisnalar bölümüne bakın.
Önerilen özellikler
Cihazınız için geçerliyse bu özellikler önerilir. Bununla birlikte, mevcut ürün işlevselliğinizle en iyi şekilde eşleşmesi için mevcut tüm özellikleri karıştırabilir ve eşleştirebilirsiniz.
Kalite gereksinimleri
- Gecikme: 1.000 ms veya daha az olmalıdır.
- Güvenilirlik: %97'den fazla veya bu değere eşit olmalıdır.
Örnek cihaz: Sade hava temizleyici
Bu bölümde, yukarıdaki cihaz türüne ve özelliklere göre ortak bir "Hava Temizleyicisi"ni temsil eden örnek amaç yükleri yer alır. Uygulamanıza özellik ekler veya uygulamanızdaki özellikleri kaldırırsanız yanıtlarınızı bu değişiklikleri yansıtacak şekilde değiştirin.
Örnek SENKRONİZASYON yanıtı
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.AIRFRESHENER", "traits": [ "action.devices.traits.OnOff", "action.devices.traits.Toggles" ], "name": { "name": "Simple air freshener" }, "willReportState": true, "attributes": { "availableToggles": [ { "name": "intermittent_key", "name_values": [ { "name_synonym": [ "Intermittent Spray" ], "lang": "en" }, { "name_synonym": [ "Intermittierender Spray" ], "lang": "de" } ] } ] }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Örnek QUERY yanıtı
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "on": true, "currentToggleSettings": { "intermittent_key": true } } } } }
Örnek EXECUTE komutları
OnOff
Komut parametreleri hakkında daha fazla bilgi için
action.devices.traits.OnOff
referansına bakın.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }
SetToggles
Komut parametreleri hakkında daha fazla bilgi için
action.devices.traits.Toggles
referansına bakın.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "intermittent_key": false } } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentToggleSettings": { "intermittent_key": false } } } ] } }