Akıllı Ev Renk Ayarı Özellik Şeması

action.devices.traits.ColorSetting: Bu özellik, renk veya renk sıcaklığını değiştirebilen akıllı ışıklar gibi cihazlar için geçerlidir.

RGB, HSV ve renk sıcaklığı

RGB, renkleri (kırmızı, yeşil, mavi) bir üçlü olarak temsil eder. RGB, varsayılan renk modelidir. Herhangi bir RGB üçlü kodu, birleştirilmiş üçlüün on altılı değerlerine eşdeğer bir onaltılık kod olarak temsil edilebilir. Örneğin, "mavi" (0, 0, 255) ve #0000FF'dir. RGB renk alanı içindeki herhangi bir değeri kullanabilirsiniz. Diğer bir deyişle, RGB(x; y; z); burada x, y, z [0, 255] aralığındadır (bu değerler dahil).

HSV, renkleri (ton, doygunluk, değer) üçlü kodu olarak temsil eder. HSV'deki herhangi bir renk değeri RGB'ye ve bunun tersi de yapılabilir. Ton [0, 360) derece aralığındadır (0 dereceye kadar sarmalandığı için 360 derece hariç). Doygunluk ve değer, [0,0, 1,0] aralığındaki kayan noktalı öğelerle temsil edilir.

Renk sıcaklığı, bazı renkleri Kelvin cinsinden negatif olmayan ondalık değerler olarak temsil eder. Bu özellik, "soğuk beyaz" veya "bulutsuz gün ışığı" gibi renk adlarıyla "beyaz" veya "sıcak" ışıkları tanımlar. Renk sıcaklığını destekleyen akıllı ışıklar genellikle [2000, 9000] Kelvin aralığındadır. Bu değer, sabit Kelvin'e sahip geleneksel ışıklara karşılık gelir. Renk sıcaklığı, RGB/HSV tam spektrumlu renk modellerinin bir alt kümesi olan doğrusal bir ölçektir. Bazı örnek sıcaklıkları ve bunlara karşılık gelen renk adlarını aşağıdaki tabloda görebilirsiniz.

Sıcaklık (Kelvin) Renk Adı
2.000Mum Işığı
2500Ultra Sıcak Beyaz
3.000Yumuşak Beyaz, Sabah Beyazı, Okuma Beyazı
4.000Soğuk Beyaz
5.000Gün Işığı, Beyaz
6.000Çiçek Beyazı
7000Bulutlu Gün Işığı, Beyaz Duman
8000Mavi Bulutlu
9000Mavi Gökyüzü

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 edinmek için Amaç karşılama bölümüne bakın.

Özellikler Type Açıklama
commandOnlyColorSetting Boole

(Varsayılan: false)

Cihazın tek yönlü (doğru) veya iki yönlü (yanlış) iletişimin kullanılmasını destekleyip desteklemediğini gösterir. Cihaz bu özellik için bir QUERY amacına veya Rapor Durumuna yanıt veremiyorsa bu özelliği true olarak ayarlayın.
Aşağıdaki öğelerin herhangi birini içerir:
0 Nesne

Renk modeli desteği.
colorModel String

Zorunludur.

Cihaz tarafından desteklenen tam spektrum renk modeli.

Desteklenen değerler:

rgb
hsv
1 Nesne

Renk sıcaklığı desteği.
colorTemperatureRange Nesne

Zorunludur.

Kelvin cinsinden desteklenen renk sıcaklığı aralığı.
temperatureMinK Integer

Zorunludur.

Kelvin cinsinden desteklenen minimum renk sıcaklığı.
temperatureMaxK Integer

Zorunludur.

Kelvin cinsinden desteklenen maksimum renk sıcaklığı.

Örnekler

Hem RGB spektrum renk modelini hem de renk sıcaklığını destekleyen cihaz.

{
  "colorModel": "rgb",
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

Yalnızca HSV spektrum renk modelini destekleyen cihaz.

{
  "colorModel": "hsv"
}

Yalnızca renk sıcaklığını destekleyen cihaz.

{
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

Yalnızca HSV renk modeli komutlarını destekleyen cihaz.

{
  "colorModel": "hsv",
  "commandOnlyColorSetting": true
}

Cihaz STATES

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

Eyaletler Type Açıklama
color Nesne

Zorunludur.

Cihazda kullanılmakta olan geçerli renk ayarı.
Aşağıdaki öğelerden birini içerir:
0 Nesne

Renk sıcaklığı desteği.
temperatureK Integer

Zorunludur.

Kelvin cinsinden sıcaklık değeri.
1 Nesne

Renk RGB spektrum desteği.
spectrumRgb Integer

Zorunludur.

Ondalık tam sayı olarak spektrum RGB değeri.
2 Nesne

Renkli HSV spektrum desteği.
spectrumHsv Nesne

Zorunludur.

Spektrum HSV değeri.
hue Number

Ton.
saturation Number

Doygunluk.
value Number

Değer.

Örnekler

Işığın rengi nedir? (Sıcak Beyaz)

{
  "color": {
    "temperatureK": 3000
  }
}

Işığın rengi nedir? (Eflatun)

{
  "color": {
    "spectrumRgb": 16711935
  }
}

Işığın rengi nedir? (Eflatun)

{
  "color": {
    "spectrumHsv": {
      "hue": 300,
      "saturation": 1,
      "value": 1
    }
  }
}

Cihaz COMMANDS

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 edinmek için Amaç karşılama bölümüne bakın.

action.devices.commands.ColorAbsolute

Mutlak renk değerini ayarlayın.

Parametreler

Parametreler Type Açıklama
color Nesne

Zorunludur.

Ayarlanacak renk.
name String

Kullanıcının komutundan ayrıştırılan renk adı; her zaman kullanılamayabilir (ör. göreli komutlar kullanılırken).
Aşağıdaki öğelerden birini içerir:
0 Nesne

Renk sıcaklığı desteği.
temperature Integer

Zorunludur.

Kelvin cinsinden sıcaklık değeri. Ayrıntılar için RGB, HSV ve renk sıcaklığı konusuna bakın.
1 Nesne

Renk RGB spektrum desteği.
spectrumRGB Integer

Zorunludur.

Ondalık tam sayı olarak spektrum RGB değeri. Ayrıntılar için RGB, HSV ve renk sıcaklığı konusuna bakın.
2 Nesne

Renkli HSV spektrum desteği.
spectrumHSV Nesne

Zorunludur.

Spektrum HSV değeri. Ayrıntılar için RGB, HSV ve renk sıcaklığı konusuna bakın.
hue Number

Ton.
saturation Number

Doygunluk.
value Number

Değer.

Örnekler

Işığı sıcak beyaz yap.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Warm White",
      "temperature": 3000
    }
  }
}

Işığı macenta yap.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Magenta",
      "spectrumRGB": 16711935
    }
  }
}

Işığı macenta yap.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Magenta",
      "spectrumHSV": {
        "hue": 300,
        "saturation": 1,
        "value": 1
      }
    }
  }
}

Komut ve durum parametreleri arasında parametre adlarının biraz farklı olduğuna dikkat edin. Bu, kullanımdan kaldırılan ColorSpectrum ve ColorTemperature özelliklerinin durum parametreleriyle çakışmaları önler.

Komut Eyalet
temperature temperatureK
spectrumRGB spectrumRgb
spectrumHSV spectrumHsv

Örnek ifadeler

de-DE

  • Stell die Farbe der Lampe auf blau
  • Stelle die Farbtemperatur auf 3000 Kelvin ein.

en-US

  • can you adjust my lights color to 4000 kelvins
  • set the lights to blue

es-ES

  • pon azul la luz de la cocina
  • pon la luz a 2000 k de temperatura de color

fr-FR

  • Allume la lampe de la chambre à 3500 kelvins .
  • mets les lampes en rose dans la chambre

hi-IN

  • तुम लाइट को ब्लू कर दो
  • लैम्प 2000 केल्विन पर लगाओ।

it-IT

  • Imposta la lampada a 2000 K .
  • metti la luce gialla

ja-JP

  • 照明 の色を 青 にして
  • 照明 の色温度を 5000K にセットして

ko-KR

  • 조명 색깔 흰색 으로 바꿔 줘
  • 주방 전등 색 온도를 5000 켈빈 으로 설정해

nl-NL

  • Zet de keukenlamp op 2000 Kelvin .
  • maak het licht rood

pt-BR

  • Colocar a lâmpada em 2000 K .
  • Define a lâmpada para 2000 K .
  • colocar a luz da sala em azul
  • põe a luz da sala a vermelho

sv-SE

  • Ställ in lampan på 2000 Kelvin
  • tänd blått ljus i köket

Cihaz ERRORS

Hataların ve istisnaların tam listesine bakın.