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

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

CİHAZ ÖZELLİKLERİ

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

Özellikler Tür Açıklama
availableFillLevels Nesne

Cihazı farklı seviyelerde doldurmayı açıklar.

levels Dizi

Zorunludur.

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

[item, ...] Nesne

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

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 dilde seviyenin eş anlamlıları.

[item, ...] Nesne

Belirli bir dilde seviyenin eş anlamlıları.

level_synonym Dizi

Zorunludur.

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

[item, ...] String

Eş anlamlı kelime adı.

lang String

Zorunludur.

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

ordered Boole

Zorunludur.

True (doğru) ise cihaz, levels dizisi (örneğin, yarı düzey) ile temsil edilen artırma veya azaltma mantığı için ek dil bilgisi uygular.

supportsFillPercent Boole

(Varsayılan: false)

Doğru ise seviyeyi yüzde olarak ayarlama komutlarını kabul eder.

Örnekler

Bağımsız dolum seviyelerini desteklemeyen temel dolum veya boşaltma özelliklerine sahip 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 STATES

Bu özelliğe sahip öğeler, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY intent'lerini ele alma hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.

Eyaletler Tür Açıklama
isFilled Boole

Zorunludur.

Cihaz herhangi bir seviyede doldurulursa doğru değerini döndürür. Cihaz tamamen boşsa yanlış değerini döndürür.

currentFillLevel String

availableFillLevels özelliği ayarlandıysa gereklidir. Cihazın doldurulduğu availableFillLevels özelliğindeki mevcut level_name değerini gösterir.

currentFillPercent Number

supportsFillPercent özelliği ayarlandıysa gereklidir. Mevcut doluluk seviyesi yüzdesini gösterir.

Örnekler

Küvet dolu mu?

{
  "isFilled": true
}

Küvet dolu mu? (seviyelerle).

{
  "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 intent'lerini ele alma hakkında daha fazla bilgi edinmek için Intent 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

Zorunludur.

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

fillLevel String

availableFillLevels özelliğindeki ayarlanacak level_name değerini belirtir. Belirtilmemişse varsayılan düzeye kadar doldurulur.

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üvetin doldurma seviyesini bir artırın (ordered özelliğinin true olması gerekir).

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

Cihaz ERRORS

Hataların ve istisnaların tam listesini inceleyin.