Akıllı Ev Dolgu Yolu Şeması

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

Cihaz ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işleminin bir parçası olarak aşağıdaki özellikleri bildirebilir. SYNC niyetlerini 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ı doldurmanın farklı 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	Dize	Zorunludur. Seviyenin dahili adı. Kullanıcı dostu olmayan bu bilgiler 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, söz konusu dildeki düzeyin standart adı olarak kullanılır.
[item, ...]	Dize	Eş anlamlı adı.
lang	Dize	Zorunludur. Dil kodu (ISO 639-1). Desteklenen dilleri inceleyin.
ordered	Boole	Zorunludur. Bu değer doğruysa cihaz, levels dizisiyle (örneğin, yarı düzey) gösterildiği şekilde, mantığı artırmaya veya azaltmaya yönelik ek dil bilgisi kurallarını işler.
supportsFillPercent	Boole	(Varsayılan: false) Doğruysa düzeyi yüzdeye göre ayarlama komutlarını kabul edin.

Örnekler

Ayrı doluluk düzeylerini desteklemeyen temel doldurma veya boşaltma özellikleri bulunan cihaz.

{}

Ayrı dolgu 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 durumu

Bu özelliğe sahip cihazlar, QUERY işleminin bir parçası olarak aşağıdaki durumları bildirebilir. QUERY niyetlerini 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. Bu değer, cihaz herhangi bir düzeyde dolarsa doğru değerini döndürür. Cihaz tamamen boşalmışsa yanlış.
currentFillLevel	Dize	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. Mevcut doluluk düzeyi yüzdesini belirtir.

Örnekler

Küvet dolu mu?

{
  "isFilled": true
}

Küvet dolu mu? (seviyelerle).

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

Cihaz FTC'leri

Bu özelliğe sahip cihazlar, EXECUTE işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE niyetlerini 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ış.
fillLevel	Dize	Ayarlanacak availableFillLevels özelliğindeki level_name değerini belirtir. Belirtilmemesi halinde varsayılan düzeye 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ısına kadar doldurun.

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

Küvet doluluk düzeyini 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.