Akıllı Su Isıtıcısı Kılavuzu
action.devices.types.KETTLE - Su ısıtıcılar, su kaynayan cihazlardır. Su ısıtıcılarıyla etkileşimler, bunları açıp kapatmak, hedef sıcaklığı ayarlamak ve çeşitli mod ayarlarını yapmak olabilir.
Bu tür, cihazın su ısıtıcısı simgesini ve ilgili bazı eş anlamlıları ve takma adları aldığını gösterir.
Su ısıtıcılar,action.devices.traits.OnOff için türe dayalı dil bilgisi kurallarına sahiptir.
Cihaz OnOff özelliğini destekliyorsa Su kaynat'a action.devices.commands.OnOff komutu gönderilir.
Cihaz özellikleri
Hizmetinizin desteklemesi gereken özellikler ve durumlar, 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.
Gerekli ö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. Bununla birlikte, mevcut ürün işlevlerinizle en iyi şekilde eşleşmesi için mevcut tüm özelliklerle karıştırıp eşleştirebilirsiniz.
Kalite gereksinimleri
- Gecikme: 800 ms'den az veya bu değere 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 ortak bir "su ısıtıcısı" temsil eden örnek yük yükleri yer alır. Uygulamanıza özellik ekler veya mevcut özellikleri kaldırırsanız bu değişiklikleri yansıtacak şekilde yanıtlarınızı uygun ş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 ek ayrıntılar 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
}
}
]
}
}
Kapalı
Komut parametreleri hakkında ek ayrıntılar 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
}
}
]
}
}