Akıllı Ev Su Yumuşatıcı Kılavuzu

action.devices.types.WATERSOFTENER - Su yumuşatıcılar, açılıp kapatılabilen, su filtresinin temizliğini ve filtre ömrünü bildiren ve çeşitli mod ayarlarına göre ayarlanabilen cihazlardır.

Bu tür, cihazın su yumuşatıcı simgesini ve ilgili bazı eş anlamlı kelimeleri ve diğer adları aldığını gösterir.

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 dokümanlarına bakın.

Bu özellikler, cihazınız için geçerliyse önerilir. Ancak mevcut ürün işlevselliğinize en iyi şekilde uymak için mevcut tüm özelliklerden dilediğinizi karıştırıp eşleştirebilirsiniz.

Örnek cihaz: Basit su yumuşatıcı

Bu bölümde, yukarıdaki cihaz türüne ve özelliklere dayalı olarak yaygın bir "Su Yumuşatıcı"yı temsil eden örnek amaç yükleri yer almaktadır. Uygulamanıza özellik ekler veya özellik kaldırırsanız yanıtlarınızı bu değişiklikleri yansıtacak şekilde düzenleyin.

Örnek SYNC yanıtı

İstek
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
Yanıt
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.WATERSOFTENER",
        "traits": [
          "action.devices.traits.OnOff",
          "action.devices.traits.SensorState"
        ],
        "name": {
          "name": "Simple water softener"
        },
        "willReportState": true,
        "attributes": {
          "sensorStatesSupported": [
            {
              "name": "FilterCleanliness",
              "descriptiveCapabilities": {
                "availableStates": [
                  "clean",
                  "dirty",
                  "needs replacement"
                ]
              }
            }
          ]
        },
        "deviceInfo": {
          "manufacturer": "smart-home-inc",
          "model": "hs1234",
          "hwVersion": "3.2",
          "swVersion": "11.4"
        }
      }
    ]
  }
}

Örnek QUERY yanıtı

İstek
{
  "requestId": "6894439706274654514",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123"
          }
        ]
      }
    }
  ]
}
Yanıt
{
  "requestId": "6894439706274654514",
  "payload": {
    "devices": {
      "123": {
        "status": "SUCCESS",
        "online": true,
        "on": true,
        "currentSensorStateData": [
          {
            "name": "FilterCleanliness",
            "currentSensorState": "clean"
          }
        ]
      }
    }
  }
}

Örnek EXECUTE komutları

OnOff

Komut parametreleri hakkında daha fazla bilgi için action.devices.traits.OnOff referansına bakın.

İstek
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.OnOff",
                "params": {
                  "on": true
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Yanıt
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "on": true
        }
      }
    ]
  }
}

Cihaz HATALARI

Hataların ve istisnaların tam listesini inceleyin.