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ı karşılama başlıklı makaleyi inceleyin.

Özellikler Tür Açıklama
availableFillLevels Nesne

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

Zorunlu.

Seviye adlarının ve dile özgü eş anlamlı kelimelerin listesi.
[item, ...] Nesne

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

Zorunlu.

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

Zorunlu.

Her desteklenen dildeki seviyenin eş anlamlıları.
[item, ...] Nesne

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

Zorunlu.

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 geri dönüşü sağlamak için lang değeri en olan en az bir öğe gereklidir.
lang String

Zorunlu.

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

Zorunlu.

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ı karşılama başlıklı makaleyi inceleyin.

Eyaletler Tür Açıklama
isFilled Boole

Zorunlu.

Cihazın şarjı herhangi bir seviyede doluysa doğru, tamamen boşsa yanlış değerini döndürür.
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.

Değer 0 ile 100 arasında olmalıdır.

Ö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ı karşılama başlıklı makaleyi inceleyin.

action.devices.commands.Fill

Cihazı doldurun veya boşaltın.

Parametreler

Parametreler Tür Açıklama
fill Boole

Zorunlu.

Doldurmak için doğru, boşaltmak için yanlış.
fillLevel String

Ayarlanacak availableFillLevels özelliğinin level_name değerini gösterir. Belirtilmemişse varsayılan düzeyde doldurulur.
fillPercent Number

İstenen seviye yüzdesini gösterir.

Değer 0 ile 100 arasında olmalıdır.

Ö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

Hatalar ve istisnalar listesinin tamamını inceleyin.