Smart Home FanSpeed Trait Schema

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

Fan hızları (yani cihazdan çeşitli seviyelerde hava üfleme; klima veya ısıtma ünitesinin 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ın karşılanması 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 raporuna yanıt veremiyorsa bu özelliği true olarak ayarlayın.
Aşağıdaki öğelerden herhangi birini içeriyorsa:
0 Nesne

Hız ayarları desteği.
availableFanSpeeds Nesne

Zorunludur.

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

Zorunludur.

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

Hız ayarı.
speed_name String

Zorunludur.

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

Zorunludur.

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 yedeklemesi sağlamak için lang değeri en olan en az bir öğe gereklidir.
speed_synonym Array

Zorunludur.

Hız ayarının eş anlamlıları, uygunsa 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 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.
ordered Boole

Zorunludur.

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

Zorunludur.

(Varsayılan: false)

True (doğru) olarak ayarlanırsa bu cihaz, hızı %0,0 ile %100,0 arasında bir yüzdeyle 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ın karşılanması 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.

Ö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ın karşılanması 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 ayarlama

Parametreler Tür Açıklama
fanSpeed String

Zorunludur.

Fan için istenen hız ayarları.

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

Parametreler Tür Açıklama
fanSpeedPercent Number

Zorunludur.

İstenen hız ayarı yüzdesi.

Örnekler

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

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

Vantilatörü %50'ye ayarla.

{
  "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 Tamsayı

Zorunludur.

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.

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

Parametreler Tür Açıklama
fanSpeedRelativePercent Number

Zorunludur.

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

Örnekler

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

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

Hata ve istisnaların tam listesini inceleyin.
  • maxSpeedReached: Cihaz zaten maksimum hıza ayarlanmış.
  • minSpeedReached: Cihaz zaten minimum hıza ayarlanmış.