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

action.devices.traits.Modes: Bu özellik, bir cihazda kullanılabilen tüm modları ve modlara özel ayarları kapsar.

Bu özellik, isteğe bağlı sayıda "n-way" özelliği olan tüm cihazlara aittir. hangi modlarda Her modun modları ve ayarları keyfidir ve her cihaza veya cihaz tipine göre benzersizdir. Her modun birden fazla ayarı vardır ancak aynı anda yalnızca bir ayar seçilebilir. Kurutucu aynı anda "hassas", "normal" ve "ağır" modda olamaz. Yalnızca etkinleştirilebilen veya devre dışı bırakılabilen ayarlar Toggles özelliğine aittir.

Örneğin, bir çamaşır makinesinin yükleme boyutu ve sıcaklık ayarları olabilir. Bunlar birbirinden bağımsız oldukları için her ikisi de moddur 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ırmak/azaltmak kelimeleriyle de ayarlanabilir. Örneğin, yükleme boyutu (küçük, orta, büyük) ve sıcaklık açıkça sıralanır (sıcaklığın diğer cihazlardaki gibi sayısal hedefi olan gerçek bir termostat olmadığını unutmayın), ancak yükleme türü (hassas, normal, yün vb.) sıralanmayabilir.

Bu özellik, kullanıcıların ayarlayabileceği bir veya daha fazla 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ğlı davranışlarda daha spesifik özellikler kullanılmalıdır (örneğin, TemperatureSetting özelliğindeki thermostatMode).

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

Zorunludur.

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

Kullanılabilir mod.
name String

Zorunludur.

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

Zorunludur.

Modun desteklenen her dilde eş anlamlıları.
[item, ...] Nesne

Belirli bir dilde modun eş anlamlıları.
name_synonym Dizi

Zorunludur.

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

Zorunludur.

Bu mod için desteklenen ayarlar.
[item, ...] Nesne

Desteklenen ayar.

En az 2 öğe gereklidir.
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 Dizi

Zorunludur.

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

Belirli bir dilde ayarın eş anlamlıları.
setting_synonym Dizi

Zorunludur.

Ayarı eş anlamlı kelimeleri. 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

(Varsayılan: false)

Bu ayar doğru değerine ayarlanırsa ayar dizisi sırasına göre (artan) artma/azalma 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 belirtir. Cihaz bir QUERY intent'ine yanıt veremiyorsa veya bu özellik için durum raporlayamıyorsa bu özelliği true olarak ayarlayın.
queryOnlyModes Boole

(Varsayılan: false)

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

Ö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 cihazlar.

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

Zorunludur.

Anahtar olarak cihazın name modu ve değer olarak mevcut setting_name değerinin bulunduğu 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 intent'lerini işleme hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.

action.devices.commands.SetModes

Mod ayarlarını güncelleyin.

Parametreler

Parametreler Tür Açıklama
updateModeSettings Nesne

Zorunludur.

Anahtar olarak cihazın name modu ve değer olarak yeni setting_name değerinin bulunduğu anahtar/değer çifti.
<string> String

Yeni setting_name.

Örnekler

Yüksek yüke 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

Hataların ve istisnaların tam listesini inceleyin.