Akıllı Ev Su ısıtıcısı rehberi
action.devices.types.KETTLE
- Su ısıtıcılar suyu kaynayan cihazlardır. Su ısıtıcılarla etkileşimler, bunları açıp kapatmak, hedef sıcaklığı ayarlamak ve çeşitli mod ayarlarını düzenlemek olabilir.
Bu tür, cihazın su ısıtıcı simgesini ve ilgili bazı eş anlamlıları ve takma adları aldığını gösterir.
Su ısıtıcılaraction.devices.traits.OnOff
için tür temelli dil bilgisi kurallarına sahiptir.
Cihaz OnOff
özelliğini destekliyorsa Su kaynat, action.devices.commands.OnOff
komutu gönderir.
Cihaz özellikleri
Hizmetinizin desteklemesi gereken özellikler ve durumlar, ayrıca EXECUTE ve QUERY yanıtlarının nasıl oluşturulacağı gibi uygulama ayrıntıları için ilgili özellik dokümanlarına bakın.
Zorunlu özellikler
Cihazınız için geçerliyse bu özellikler ve komutlar gerekir.
Önerilen özellikler
Cihazınız için geçerliyse bu özellikler önerilir. Ancak mevcut ürün işlevlerinizle en iyi eşleşmeyi sağlamak için mevcut tüm özelliklerle karıştırabilir ve eşleştirebilirsiniz.
Kalite gereksinimleri
- Gecikme: 800 ms'den küçük veya buna eşit olmalıdır.
- Güvenilirlik: %97'den fazla veya bu değere eşit olmalıdır.
Örnek cihaz: Basit su ısıtıcı
Bu bölümde, cihaz türüne ve yukarıdaki özelliklere göre genel bir "kemer"in temsil edildiği amaç yükü örnekleri yer almaktadır. Uygulamanıza özellikler ekler veya mevcut özellikleri kaldırırsanız yanıtlarınızı bu değişiklikleri yansıtacak şekilde değiştirin.
Örnek SYNC yanıtı
{ "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" } } ] } }
Ö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, "temperatureSetpointCelsius": 100 } } } }
Örnek EXECUTE komutları
Sıcaklığı Ayarlayın
Komut parametreleri hakkında daha fazla bilgi için action.devices.traits.TemperatureControl
referansına bakın.
{ "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 } } ] } }
Devre Dışı
Komut parametreleri hakkında daha fazla bilgi için action.devices.traits.OnOff
referansına bakın.
{ "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 } } ] } }