Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenebileceğiniz yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem derlemeye devam edersiniz.

Akıllı Ev Modları Özellik Şeması

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

Bu özellik, herhangi bir cihazın modlarının ve ayarlarının her cihazda veya cihaz türünde rastgele olarak seçildiği rastgele "yön" modlarına sahip tüm cihazlara aittir. Her modda birden çok olası ayar vardır ancak bir kerede yalnızca bir tanesi seçilebilir; kurutma makinesi aynı anda "nazik", "normal" ve "ağır yük" modunda olamaz. Kolayca açılabilen veya kapatılabilen bir ayar, Geçişler özelliğine aittir.

Örneğin, bir çamaşır makinesinin yük boyutu ve sıcaklığıyla ilgili ayarları olabilir. Birbirlerinden bağımsız oldukları için bunların her ikisi de mod olurdu, ancak her biri aynı anda yalnızca bir durumda olabilir. Kullanıcı, Temizleyicinin sıcaklığını soğuk olarak ayarla gibi bir komutla sıcaklık gibi bir mod ayarlayabilir.

Bazı modlar "sıralı"dır, ayrıca yukarı/aşağı hareketleriyle ayarlanabilir, artışı/azaltma ifadeleri kullanılabilir. Örneğin, yükleme boyutu (küçük, orta, büyük) ve sıcaklık açıkça sıralanmıştır (sıcaklığın, diğer cihazlarda olduğu gibi sayısal bir hedefi olan gerçek bir termometri olmadığını unutmayın). Ancak, yükleme türü (şarkılar, normal, yün vb.) kullanılmayabilir.

Bu özellik, kullanıcıların ayarlayabileceği bir veya daha fazla modu kapsar. Genel olarak bu modlar, diğer cihaz davranışının bağlantısı kaldırılan işlevler için kullanılmalıdır. Cihazın kendisinin açılması veya kapatılması gibi bağlantılı davranışlar, daha belirli özellikler (ör. TemperatureSettings özelliğindeki thermostatMode) kullanmalıdır.

Cihaz ATTRIBUTES

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

Özellikler Type Açıklama
availableModes Dizi

Zorunludur.

Kullanılabilir modların listesi.

[item, ...] Nesne

Kullanılabilir mod.

name Dize

Zorunludur.

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

name_values Dizi

Zorunludur.

Desteklenen her dilde modun eş anlamlıları.

[item, ...] Nesne

Modun belirli bir dildeki eş anlamlıları.

name_synonym Dizi

Zorunludur.

Modun eş anlamlıları. Bu listedeki ilk dize, ilgili dildeki düzeyin standart adı olarak kullanılır.

[item, ...] Dize

Eş anlamlı ad.

lang Dize

Zorunludur.

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

settings Dizi

Zorunludur.

Bu mod için desteklenen ayarlar.

[item, ...] Nesne

Desteklenen ayar.

En az 2 öğe gerekir.

setting_name Dize

Zorunludur.

Komutlar ve durumlarda kullanılacak mod ayarının dahili adı. Bu özellik kullanıcı dostu olmayabilir ve tüm dillerde paylaşılır.

setting_values Dizi

Zorunludur.

Ayarın desteklenen her dilde eş anlamlıları.

[item, ...] Nesne

Ayarın belirli bir dildeki eş anlamlıları.

setting_synonym Dizi

Zorunludur.

Ayarın eş anlamlıları. Bu listedeki ilk dize, ilgili dildeki düzeyin standart adı olarak kullanılır.

[item, ...] Dize

Eş anlamlı ad.

lang Dize

Zorunludur.

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

ordered Boole

(Varsayılan: false)

Politika doğru değerine ayarlanırsa artış/azaltma mantığı için dil bilgisinin ayarlar dizisindeki sırayla (artan) kullanılması gerekir.

commandOnlyModes Boole

(Varsayılan: false)

Cihazın tek yönlü (doğru) veya iki yönlü (yanlış) iletişimi destekleyip desteklemediğini belirtir. Cihaz, bu özellik için bir QUERY amacına veya Rapor Durumuna yanıt veremezse bu özelliği doğru olarak ayarlayın.

queryOnlyModes Boole

(Varsayılan: false)

Cihaz yalnızca sorgu yürütmeyi destekliyorsa gerekir. Bu özellik, cihazın yalnızca durum bilgisi için sorgulanıp sorgulanamayacağını ve kontrol edilemediğini gösterir.

Örnekler

Birden fazla modu ve ayarları olan 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ı olan 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 STATUS

Bu özelliğe sahip varlıklar, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY amaçlarını işleme hakkında daha fazla bilgi için Amaç karşılama bölümüne bakın.

Eyaletler Type Açıklama
currentModeSettings Nesne

Zorunludur.

Anahtar olarak cihazın name modunu ve değer olarak geçerli setting_name ifadesini içeren anahtar/değer çifti.

<string> Dize

Şu anda setting_name.

Örnekler

Cihaz hangi modda?

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

Cihaz Komisyonları

Bu özelliğe sahip cihazlar, EXECUTE işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE amaçlarını işleme hakkında daha fazla bilgi için Amaç karşılama bölümüne bakın.

action.devices.commands.SetModes

Mod ayarlarını güncelleyin.

Parametreler

Parametreler Type Açıklama
updateModeSettings Nesne

Zorunludur.

Cihazın modu name olarak, anahtar/değer çifti ise yeni setting_name olarak değer çifti olarak ayarlanır.

<string> Dize

Yeni setting_name

Örnekler

Büyük yüke ayarla.

{
  "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.