Smart Home FanSpeed Trait Schema

action.devices.traits.FanSpeed: Bu özellik, fan hızının ayarlanmasını destekleyen cihazlara aittir.

Fan hızları (ör. cihazdan çeşitli seviyelerde hava üfleme; klima veya ısıtma biriminin ya da arabanın bir parçası olabilir) düşük, orta ve yüksek gibi ayarlar ya da bir yüzde içerebilir.

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ı karşılama başlıklı makaleyi inceleyin.

Özellikler Tür Açıklama
reversible Boole

(Varsayılan: false)

True (doğru) olarak ayarlanırsa bu cihaz, pervaneyi her iki yönde de döndürmeyi destekler ve pervane yönünü tersine çevirme komutunu kabul edebilir.
commandOnlyFanSpeed 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 Raporu'na yanıt veremiyorsa bu özelliği doğru olarak ayarlayın.
Aşağıdaki öğelerden herhangi birini içerir:
0 Nesne

Hız ayarları desteği.
availableFanSpeeds Nesne

Zorunlu.

Cihazın desteklediği hız ayarları.
speeds Array

Zorunlu.

Hız ayarlarının listesi.
[item, ...] Nesne

Hız ayarı.
speed_name String

Zorunlu.

Hız ayarının dahili adı. Bu durum, kullanıcı dostu olmayabilir ve tüm dillerde paylaşılır.
speed_values Array

Zorunlu.

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

Belirli bir dildeki hız ayarının eş anlamlısı. Dil geri dönüşü sağlamak için lang değeri en olan en az bir öğe gereklidir.
speed_synonym Array

Zorunlu.

Hız ayarının eş anlamlıları, varsa hem tekil hem de çoğul biçimleri içermelidir. Listedeki ilk eş anlamlı kelime, hız ayarının standart adı olarak kabul edilir.
[item, ...] String

Eş anlamlı. Dil geri dönüşü sağlamak için lang değeri en olan en az bir öğe gereklidir.
lang String

Zorunlu.

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

Zorunlu.

Doğru olarak ayarlanırsa hız dizisinin sırasına (artış) göre artış veya azalış mantığı için ek dil bilgisi uygulanır.
1 Nesne

Hız yüzdesi desteği.
supportsFanSpeedPercent Boole

Zorunlu.

(Varsayılan: false)

True (doğru) olarak ayarlanırsa bu cihaz, hızı %0,0 ile %100,0 arasında bir yüzde kullanarak ayarlama komutlarını kabul eder.

Örnekler

İki hız ayarı, ters yönde destek ve yüzde ayarlamaları olan cihaz.

{
  "availableFanSpeeds": {
    "speeds": [
      {
        "speed_name": "speed_low",
        "speed_values": [
          {
            "speed_synonym": [
              "Low",
              "Slow"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "speed_name": "speed_high",
        "speed_values": [
          {
            "speed_synonym": [
              "High",
              "Fast"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  },
  "reversible": true,
  "supportsFanSpeedPercent": true
}

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ı karşılama başlıklı makaleyi inceleyin.

Eyaletler Tür Açıklama
currentFanSpeedSetting String

Bu, availableFanSpeeds özelliğindeki mevcut hız ayarının dahili adını gösterir.
currentFanSpeedPercent Number

Mevcut fan hızını yüzde olarak gösterir. supportsFanSpeedPercent özelliği true olarak ayarlanmışsa zorunludur.

Değer 0 ile 100 arasında olmalıdır.

Örnekler

Salondaki fanların hızı nedir?

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}

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ı karşılama başlıklı makaleyi inceleyin.

action.devices.commands.SetFanSpeed

Hızı ayarlayın.

Parametreler

Yük aşağıdakilerden birini içeriyor:

Hızı ayarlardan ayarlayın.

Parametreler Tür Açıklama
fanSpeed String

Zorunlu.

Fan için istenen hız ayarları.

Hızı yüzde olarak ayarlayın.

Parametreler Tür Açıklama
fanSpeedPercent Number

Zorunlu.

İstenen hız ayarı yüzdesi.

Değer 0 ile 100 arasında olmalıdır.

Örnekler

Fan hızını yüksek seviyeye ayarlayın.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeed": "speed_high"
  }
}

Vantilatörü %50'ye ayarlayın.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeedPercent": 50
  }
}

action.devices.commands.SetFanSpeedRelative

Bağıl hızı ayarlayın.

Bu komut için aşağıdaki özellikler gerekir: 
{
  "commandOnlyFanSpeed": true
}

Parametreler

Yük aşağıdakilerden birini içeriyor:

Ağırlığa göre bağıl hızı ayarlayın.

Parametreler Tür Açıklama
fanSpeedRelativeWeight Integer

Zorunlu.

Bu değer, hız değişikliğinin göreli miktarını gösterir. Mutlak değer, ölçeklendirilmiş tutarı gösterirken sayısal işaret, değişikliğin yönünü gösterir.

Değer -5 ile 5 arasında olmalıdır.

Bağıl hızı yüzde olarak ayarlayın.

Parametreler Tür Açıklama
fanSpeedRelativePercent Number

Zorunlu.

Bu değer, hızın değişme yüzdesini gösterir.

Değer -100 ile 100 arasında olmalıdır.

Örnekler

Fan hızını biraz düşürün.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativeWeight": -1
  }
}

Fan hızını yüzde 10 artır.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativePercent": 10
  }
}

action.devices.commands.Reverse

Fan yönünü tersine çevirin.

Bu komut için aşağıdaki özellikler gerekir: 
{
  "reversible": true
}

Parametreler

Parametreler Tür Açıklama

Özellik yok

Örnekler

Fan yönünü tersine çevirin.

{
  "command": "action.devices.commands.Reverse",
  "params": {}
}

Örnek ifadeler

de-DE

  • stell die Geschwindigkeit vom Ventilator auf hoch

en-US

  • drop the AC fan speed to medium

es-ES

  • cambia la velocidad del ventilador a medio

fr-FR

  • mets la ventilation au maximum

hi-IN

  • बेडरूम में पंखे की गति मीडियम करें

it-IT

  • metti il condizionatore in salotto a velocità media

ja-JP

  • エアコン の風量を 高速 にセット

ko-KR

  • 선풍기 강풍 으로 틀어 줘

nl-NL

  • zet de snelheid van de ventilator op medium

pt-BR

  • definir a velocidade do ventilador para baixa
  • põe a ventoinha no máximo

sv-SE

  • Ställ in fläkten på medel

Cihaz HATALARI

Hatalar ve istisnalar listesinin tamamını inceleyin.
  • maxSpeedReached: Cihaz zaten maksimum hıza ayarlanmış.
  • minSpeedReached: Cihaz zaten minimum hıza ayarlanmış.