Akıllı Ev Doldurma Kapağı Şeması

action.devices.traits.Fill - Bu özellik, küvet gibi doldurulmayı destekleyen cihazlar için geçerlidir.

Cihaz ATTRIBUTES

Bu özelliğe sahip cihazlar, SYNC işleminin bir parçası olarak aşağıdaki özellikleri bildirebilir. SYNC amaçlarını işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.

Özellikler Tür Açıklama
availableFillLevels Nesne

Cihazın farklı doldurma seviyelerini açıklar.

levels Dizi

Zorunludur.

Seviye adlarının ve dile özgü eş anlamlıların listesi.

[item, ...] Nesne

Seviye adı ve dile özgü eş anlamlıları.

level_name String

Zorunludur.

Seviyenin dahili adı. Bu, kullanıcı dostu olmayabilir ve tüm dillerde paylaşılır.

level_values Dizi

Zorunludur.

Desteklenen her dildeki düzeyin eş anlamlıları.

[item, ...] Nesne

Seviyenin belirli bir dildeki eş anlamlıları.

level_synonym Dizi

Zorunludur.

Seviyenin eş anlamlısı. Bu listedeki ilk dize, ilgili dildeki düzeyin standart adı olarak kullanılır.

[item, ...] String

Eş anlamlı ad.

lang String

Zorunludur.

Dil kodu (ISO 639-1). Desteklenen dillere bakın.

ordered Boole

Zorunludur.

Doğru değerine ayarlanırsa cihaz, levels dizisiyle temsil edildiği şekilde (örneğin, yarım düzey) artış veya azalma mantığı için ek dilbilgisini işler.

supportsFillPercent Boole

(Varsayılan: false)

True (doğru) değerine ayarlanırsa düzeyi yüzdeye ayarlamak için kullanılan komutları kabul edin.

Örnekler

Ayrı dolu doldurma düzeylerini desteklemeyen temel doldurma veya boşaltma özelliklerine sahip cihaz.

{}

Ayrı doluluk düzeylerini destekleyen cihaz.

{
  "availableFillLevels": {
    "levels": [
      {
        "level_name": "half_level",
        "level_values": [
          {
            "level_synonym": [
              "Half",
              "Half way",
              "One half"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "level_name": "full_level",
        "level_values": [
          {
            "level_synonym": [
              "Full",
              "All the way",
              "Complete"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  }
}

Cihaz STATES

Bu özelliğe sahip varlıklar, QUERY işleminin bir parçası olarak aşağıdaki durumları bildirebilir. QUERY amaçlarını işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.

Eyaletler Tür Açıklama
isFilled Boole

Zorunludur.

Cihaz herhangi bir düzeye doldurulmuşsa doğru değerini alır. Cihaz tamamen boşaltılmışsa yanlış değerini alır.

currentFillLevel String

availableFillLevels özelliği ayarlanmışsa zorunludur. Cihazın doldurulduğu availableFillLevels özelliğindeki mevcut level_name değerini gösterir.

currentFillPercent Number

supportsFillPercent özelliği ayarlanmışsa zorunludur. Mevcut doluluk seviyesi yüzdesini belirtir.

Örnekler

Küvet dolu mu?

{
  "isFilled": true
}

Küvet dolu mu? (seviyelerle birlikte).

{
  "isFilled": true,
  "currentFillLevel": "half_level"
}

Cihaz COMMANDS

Bu özelliğe sahip cihazlar, EXECUTE işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE amaçlarını işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.

action.devices.commands.Fill

Cihazı doldurun veya boşaltın.

Parametreler

Parametreler Tür Açıklama
fill Boole

Zorunludur.

Doldurmak için doğru, boşaltmak için yanlış değerini alır.

fillLevel String

Ayarlanacak availableFillLevels özelliğindeki level_name değerini gösterir. Belirtilmemişse varsayılan düzeyi doldurun.

fillPercent Number

İstenen seviye yüzdesini belirtir.

Örnekler

Küveti doldurun.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true
  }
}

Küveti boşaltın.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": false
  }
}

Küveti yarıya kadar doldurun.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "half_level"
  }
}

Küvet doldurma seviyesini bir artırın (ordered özelliğinin true olmasını zorunlu kılın).

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "full_level"
  }
}

Cihaz ERRORS

Hataların ve istisnaların tam listesine bakın.