Akıllı Ev İçin Nem Giderici Kılavuzu

action.devices.types.DEHUMIDIFIER: Nem alıcılar, havadaki nemi temizleyen cihazlardır. Bu cihazlar açılıp kapatılabilir, hedef nem oranı bildirilip ayarlanabilir ve çeşitli modları veya fan hızı ayarları olabilir.

Bu tür, cihazın nem alıcı simgesini ve ilgili bazı öğeleri içerdiğini gösterir. eşanlamları ve takma adlar vardır.

Cihaz özellikleri

Şu özellikler için ilgili özellik dokümanlarına bakın: hizmetinizin desteklemesi gereken özellikler ve eyaletler gibi uygulama ayrıntılarını EXECUTE ve QUERY yanıtları oluşturun.

Gerekli özellikler

Bu özellikler ve komutlar, mobil uygulama veya olanak tanır. Cihazınız bu özellikleri desteklemiyorsa Bir QUERY veya EXECUTE yanıtında functionNotSupported. Görüntüleyin Hatalar ve istisnalar başlıklı makaleden daha fazla bilgi edinebilirsiniz.

Bu özellikler (cihazınız için geçerliyse) önerilir. Ancak mevcut karakterlerinizle en iyi şekilde eşleşmesi için mevcut tüm özellikleri karıştırıp eşleştirebilirsiniz. fayda sağlar.

Kalite gereksinimleri

  • Gecikme: 1.000 ms'den az veya buna eşit olmalıdır.
  • Güvenilirlik: %97'den fazla veya buna eşit olmalıdır.

Örnek cihaz: Basit nem alıcı

Bu bölümde, yaygın bir "Nem alıcı" cihazı temsil eden amaç yükü örnekleri verilmiştir. yukarıdaki cihaz türüne ve özelliklere göre değişir. Uygulamanızda özellikler ekler veya mevcut özellikleri kaldırırsanız ve yanıtlarınızı bu değişikliklere göre değiştirmeniz gerekir.

Ö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.DEHUMIDIFIER",
        "traits": [
          "action.devices.traits.FanSpeed",
          "action.devices.traits.HumiditySetting",
          "action.devices.traits.OnOff"
        ],
        "name": {
          "name": "Simple dehumidifier"
        },
        "willReportState": true,
        "attributes": {
          "humiditySetpointRange": {
            "minPercent": 5,
            "maxPercent": 50
          },
          "availableFanSpeeds": {
            "speeds": [
              {
                "speed_name": "low_key",
                "speed_values": [
                  {
                    "lang": "en",
                    "speed_synonym": [
                      "Low",
                      "Slow"
                    ]
                  },
                  {
                    "lang": "de",
                    "speed_synonym": [
                      "Niedrig",
                      "Schleppend"
                    ]
                  }
                ]
              },
              {
                "speed_name": "high_key",
                "speed_values": [
                  {
                    "lang": "en",
                    "speed_synonym": [
                      "High"
                    ]
                  },
                  {
                    "lang": "de",
                    "speed_synonym": [
                      "Hoch"
                    ]
                  }
                ]
              }
            ],
            "ordered": true
          }
        },
        "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,
        "currentFanSpeedSetting": "low_key",
        "humiditySetpointPercent": 10,
        "humidityAmbientPercent": 20
      }
    }
  }
}

Örnek EXECUTE komutları

SetFanSpeed

Komut parametreleriyle ilgili ek ayrıntılar için bkz. action.devices.traits.FanSpeed bir referans noktası olarak kabul edilir.

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

SetHumidity

Komut parametreleriyle ilgili ek ayrıntılar için bkz. action.devices.traits.HumiditySetting bir referans noktası olarak kabul edilir.

İstek
{
  "requestId": "6894439706274654518",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.SetHumidity",
                "params": {
                  "humidity": 15
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Yanıt
{
  "requestId": "6894439706274654518",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "humiditySetpointPercent": 15,
          "humidityAmbientPercent": 20
        }
      }
    ]
  }
}

OnOff

Komut parametreleriyle ilgili ek ayrıntılar için bkz. action.devices.traits.OnOff bir referans noktası olarak kabul edilir.

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

Cihaz ERRORS

Tam listeye göz atın: hataları ve istisnaları ortadan kaldırın.