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

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

CİHAZ ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC intent'lerini işleme hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.

Özellikler Tür Açıklama
availableFillLevels Nesne

Cihazın doldurulma düzeylerini 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 dilleri inceleyin.
ordered Boole

Zorunludur.

Doğruysa cihaz, levels dizisiyle temsil edilen artma veya azalma mantığı için ek dil bilgisini işler (örneğin, yarım seviye).
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 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 intent'lerini işleme 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 seviyeye kadar doldurulmuşsa doğru değerini döndürür. Cihazın şarjı tamamen bitmişse 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 işleme 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

Ayarlanacak availableFillLevels özelliğindeki 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üvet doluluk seviyesini bir artırın (ordered özelliğinin true olması gerekir).

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

Cihaz HATALARI

Hataların ve istisnaların tam listesini inceleyin.