Akıllı Ev Dolgusu Ş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 için Amaç karşılama bölümüne bakın.

Özellikler	Type	Açıklama
availableFillLevels	Nesne	Cihazı doldurmanın farklı seviyelerini açıklar.
levels	Dizi	Zorunludur. Seviye adları ve dile özel eş anlamlılar listesi.
[item, ...]	Nesne	Seviye adı ve dile özgü eş anlamlıları.
level_name	String	Zorunludur. Seviyenin dahili adı. Bu özellik kullanıcı dostu olmayabilir ve tüm dillerde paylaşılır.
level_values	Dizi	Zorunludur. Desteklenen her dilde düzeyin eş anlamlıları.
[item, ...]	Nesne	Belirli bir dildeki düzeyin 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. True (doğru) olarak ayarlanırsa cihaz, levels dizisi (ör. yarı düzey) ile temsil edilen artış veya azalma mantığı için ek dil bilgisi kurallarını uygular.
supportsFillPercent	Boole	(Varsayılan: false) Doğru ise düzeyi yüzdeye ayarlamak için komutları kabul edin.

Örnekler

Ayrı doldurma seviyelerini desteklemeyen temel doldurma veya boşaltma özellikleri olan 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 STATUS

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

Eyaletler	Type	Açıklama
isFilled	Boole	Zorunludur. Cihaz herhangi bir düzeydeyse doğru değerini döndürür. Cihaz tamamen boşalmışsa yanlış değerini alır.
currentFillLevel	String	availableFillLevels özelliği ayarlanmışsa gereklidir. Cihazın doldurulduğu availableFillLevels özelliğindeki mevcut level_name değerini belirtir.
currentFillPercent	Number	supportsFillPercent özelliği ayarlanmışsa gereklidir. Geçerli doluluk düzeyi yüzdesini belirtir.

Örnekler

Küvet dolu mu?

{
  "isFilled": true
}

Küvet dolu mu? (seviyelerle)

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

Cihaz Komisyonları

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 için Amaç karşılama bölümüne bakın.

action.devices.commands.Fill

Cihazı doldurun veya boşaltın.

Parametreler

Parametreler	Type	Açıklama
fill	Boole	Zorunludur. Doldurmak için doğru, boşaltmak için yanlış.
fillLevel	String	Ayarlanacak availableFillLevels özelliğindeki level_name değerini belirtir. Belirtilmemesi halinde varsayılan düzeyi doldurun.
fillPercent	Number	İstenen seviye yüzdesini gösterir.

Ö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ısına kadar doldurun.

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

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

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

Cihaz HATALARI

Hataların ve istisnaların tam listesini inceleyin.