Akıllı Ev Doldurma Özelliği Şeması

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

Cihaz ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacın karşılanması başlıklı makaleyi inceleyin.

Özellikler Tür Açıklama
availableFillLevels Nesne

Cihazın farklı doluluk seviyelerini açıklar.
levels Array

Zorunludur.

Seviye adlarının ve dile özgü eş anlamlı kelimelerin 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 Array

Zorunludur.

Seviyenin, desteklenen her dildeki eş anlamlıları.
[item, ...] Nesne

Belirli bir dildeki seviyenin eş anlamlıları. Dil yedeklemesi sağlamak için lang değeri en olan en az bir öğe gereklidir.
level_synonym Array

Zorunludur.

Seviyenin eş anlamlısı. Bu listedeki ilk dize, söz konusu dildeki seviyenin standart adı olarak kullanılır.
[item, ...] String

Eş anlamlı kelime adı. Dil yedeklemesi sağlamak için lang değeri en olan en az bir öğe gereklidir.
lang String

Zorunludur.

Dil kodu (ISO 639-1). Desteklenen dilleri görün.
ordered Boole

Zorunludur.

Doğruysa cihaz, levels dizisiyle gösterildiği gibi artırma veya azaltma mantığı için ek dilbilgisi işler (ör. yarım seviye).
supportsFillPercent Boole

(Varsayılan: false)

Doğruysa seviyeyi belirli bir yüzdeye ayarlama komutlarını kabul edin.

Örnekler

Ayrı dolum seviyelerini desteklemeyen, temel dolum veya boşaltma özelliklerine sahip cihaz.

{}

Ayrı doluluk seviyelerini 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 DURUMLARI

Bu özelliğe sahip öğeler, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacın karşılanması başlıklı makaleyi inceleyin.

Eyaletler Tür Açıklama
isFilled Boole

Zorunludur.

Cihaz herhangi bir seviyede doldurulmuşsa doğru değerini döndürür. Cihazın pili tamamen bittiyse yanlış.
currentFillLevel String

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

supportsFillPercent özelliği ayarlanmışsa zorunludur. Mevcut doluluk seviyesinin yüzdesini gösterir.

Örnekler

Küvet dolu mu?

{
  "isFilled": true
}

Küvet dolu mu? (seviyelerle birlikte).

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

Cihaz KOMUTLARI

Bu özelliğe sahip cihazlar, EXECUTE işlemi kapsamında aşağıdaki komutlara yanıt verebilir. EXECUTE amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacın karşılanması başlıklı makaleyi inceleyin.

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 String

Ayarlanacak availableFillLevels özelliğinden level_name değerini gösterir. Belirtilmemişse varsayılan düzeye kadar 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üvetin doluluk seviyesini bir artır (ordered özelliğinin true olması gerekir).

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

Cihaz HATALARI

Hata ve istisnaların tam listesini inceleyin.