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

action.devices.traits.Modes - Bu özellik, bir cihaz için kullanılabilen tüm modları ve moda özgü ayarları kapsar.

Bu özellik, modların ve her modun ayarlarının rastgele olduğu ve her cihaza veya cihaz türüne özgü olduğu, rastgele sayıda "n-way" modu olan tüm cihazlara aittir. Her modun birden fazla olası ayarı vardır ancak aynı anda yalnızca bir ayar seçilebilir. Kurutma makinesi aynı anda "hassas", "normal" ve "ağır hizmet" modunda olamaz. Basitçe etkinleştirilebilen veya devre dışı bırakılabilen bir ayar Toggles özelliğine aittir.

Örneğin, bir çamaşır makinesinde yükleme boyutu ve sıcaklık ayarları olabilir. Bunlar birbirinden bağımsız oldukları için mod olarak kabul edilir ancak her biri aynı anda yalnızca bir durumda olabilir. Kullanıcı, Çamaşır makinesinin sıcaklığını soğuk olarak ayarla gibi bir komutla sıcaklık gibi bir modu açıkça ayarlayabilir.

Bazı modlar "sıralı"dır ve yukarı/aşağı, artır/azalt ifadeleriyle de ayarlanabilir. Örneğin, yük boyutu (küçük, orta, büyük) ve sıcaklık net bir şekilde sıralanır (sıcaklığın diğer cihazlardaki gibi sayısal hedefli gerçek bir termostat olmadığını unutmayın). Ancak yük türü (hassas, normal, yün vb.) sıralanmayabilir.

Bu özellik, kullanıcıların ayarlayabileceği bir veya daha fazla bireysel modu kapsar. Genel olarak bu modlar, diğer cihaz davranışlarıyla bağlantısı olmayan işlevler için kullanılmalıdır. Cihazın kendisini açma veya kapatma gibi bağlantılı davranışlar daha spesifik özellikler (ör. TemperatureSetting özelliğindeki thermostatMode) kullanmalıdır.

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
availableModes Array

Zorunludur.

Kullanılabilir modların listesi.
[item, ...] Nesne

Kullanılabilir mod.
name String

Zorunludur.

Modun dahili adı. Komutlarda ve durumlarda kullanılır. Bu, kullanıcı dostu olmayabilir ve tüm dillerde paylaşılır.
name_values Array

Zorunludur.

Desteklenen her dildeki modun eş anlamlıları.
[item, ...] Nesne

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

Zorunludur.

Modun eş anlamlıları. 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.
settings Array

Zorunludur.

Bu modda desteklenen ayarlar.
[item, ...] Nesne

Desteklenen ayar.

En az 2 öğe gerektirir.
setting_name String

Zorunludur.

Mod ayarının, komutlarda ve durumlarda kullanılacak dahili adı. Bu, kullanıcı dostu olmayabilir ve tüm dillerde paylaşılır.
setting_values Array

Zorunludur.

Desteklenen her dildeki ayarın eş anlamlıları.
[item, ...] Nesne

Belirli bir dildeki ayarın eş anlamlıları.
setting_synonym Array

Zorunludur.

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

Eş anlamlı kelime adı.
lang String

Zorunludur.

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

(Varsayılan: false)

Bu ayar doğru olarak belirlenirse ayarlar dizisinin sırasına göre (artarak) artırma/azaltma mantığı için ek dil bilgisi uygulanır.
commandOnlyModes Boole

(Varsayılan: false)

Cihazın tek yönlü (doğru) veya iki yönlü (yanlış) iletişimi destekleyip desteklemediğini gösterir. Cihaz, bu özellik için QUERY amacına veya durum raporuna yanıt veremiyorsa bu özelliği true olarak ayarlayın.
queryOnlyModes Boole

(Varsayılan: false)

Cihaz sorgu tabanlı yürütmeyi destekliyorsa gereklidir. Bu özellik, cihazın yalnızca durum bilgileri için sorgulanıp sorgulanamayacağını ve kontrol edilip edilemeyeceğini gösterir.

Örnekler

Birden fazla mod ve ayara sahip cihaz.

{
  "availableModes": [
    {
      "name": "load_mode",
      "name_values": [
        {
          "name_synonym": [
            "Load",
            "Size",
            "Load size"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "small_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Small",
                "Half"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "medium_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Medium",
                "Normal"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "large_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Large",
                "Full"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": true
    },
    {
      "name": "temp_mode",
      "name_values": [
        {
          "name_synonym": [
            "Temperature",
            "Temp"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "hot_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Hot",
                "White"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "warm_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Warm",
                "Color"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "cold_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Cold",
                "Delicate"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ]
}

Yalnızca komut modlarına sahip cihaz.

{
  "availableModes": [
    {
      "name": "light_mode",
      "name_values": [
        {
          "name_synonym": [
            "Light",
            "Lighting"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "day_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Day",
                "Bright"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "night_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Night",
                "Dark"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "reading_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Reading",
                "Ambiant"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ],
  "commandOnlyModes": true,
  "queryOnlyModes": false
}

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
currentModeSettings Nesne

Zorunludur.

Anahtar olarak cihazın modu name, değer olarak ise geçerli setting_name olan anahtar/değer çifti.
<string> String

Şu anda setting_name.

Örnekler

Cihaz hangi modda?

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

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.SetModes

Mod ayarlarını güncelleyin.

Parametreler

Parametreler Tür Açıklama
updateModeSettings Nesne

Zorunludur.

Cihazın modu name anahtar, yeni setting_name ise değer olarak anahtar/değer çifti.
<string> String

Yeni setting_name.

Örnekler

Büyük yüklemeye ayarlayın.

{
  "command": "action.devices.commands.SetModes",
  "params": {
    "updateModeSettings": {
      "load_mode": "large_load"
    }
  }
}

Örnek ifadeler

de-DE

  • Stelle den Staubsauger auf Ruhemodus

en-US

  • set the vacuum to energy saver mode

es-ES

  • pon la lavadora en modo frío

fr-FR

  • mets l'aspirateur en silencieux

hi-IN

  • वैक्यूम पर कार्पेट मोड लगाएं

it-IT

  • imposta l'aspirapolvere su silenzioso

ja-JP

  • 掃除機 を 静音 モードに設定して

ko-KR

  • 세탁기 세탁량 많음 으로 설정해

pt-BR

  • acionar a função autolimpeza do aspirador
  • ligar o modo de aquecimento

Cihaz HATALARI

Hata ve istisnaların tam listesini inceleyin.