Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenmek için yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem oluşturmaya devam edersiniz.
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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.