Akıllı Ev için 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üsü, bir onaltılık kod olarak temsil edilebilir. Bu, üçlünün birleştirilen onaltılı değerlerine eşittir. Örneğin, "mavi", (0, 0, 255) ve #0000FF'dir. RGB renk alanındaki herhangi bir değeri kullanabilirsiniz. Yani x, y, z değerlerinin [0, 255] aralığında olduğu RGB(x, y, z).

HSV, renkleri (ton, doygunluk, değer) üçlüsü olarak temsil eder. HSV'deki herhangi bir renk değeri RGB'ye dönüştürülebilir ve bunun tersi de geçerlidir. Ton, [0, 360) derece aralığındadır (0 dereceye yuvarlandığı için 360 hariç). Doygunluk ve değer, [0,0, 1,0] aralığındaki kayan sayılarla temsil edilir.

Renk sıcaklığı, bazı renkleri Kelvin cinsinden negatif olmayan ondalık değerleri olarak temsil eder. Bu özellik, "soğuk beyaz" veya "bulutlu gün ışığı" gibi renk adlarıyla "beyaz" ya da "sıcak" ışıkları tanımlar. Renk sıcaklığını destekleyen akıllı ışıklar genellikle [2000, 9000] Kelvin aralığındadır. Bu da sabit Kelvin'e sahip geleneksel ışıklara karşılık gelir. Renk sıcaklığı, doğrusal bir ölçek ve RGB/HSV tam spektrumlu renk modellerinin bir alt kümesidir. Bazı örnek sıcaklıklar ve ilgili renk adları için aşağıdaki tabloya bakın.

Sıcaklık (Kelvin) Renk Adı
2000Mum ışığı
2500Ultra Sıcak Beyaz
3000Yumuşak Beyaz, Sabah Beyaz, Okuma Beyaz
4000Soğuk Beyaz
5000Gün ışığı, beyaz
6.000Çiçek Beyazı
7000Bulutlu Gün Işığı, Beyaz Duman
8000Mavi bulutlu gökyüzü
9000Blue Sky

CİHAZ ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC intent'lerini ele alma hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.

Özellikler Tür Açıklama
commandOnlyColorSetting 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.
Aşağıdaki öğelerden herhangi birini içerir:
0 Nesne

Renk modeli desteği.
colorModel String

Zorunludur.

Cihaz tarafından desteklenen tam spektrumlu 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 Tamsayı

Zorunludur.

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

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

{
  "colorModel": "hsv"
}

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

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

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

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

Cihaz DURUMLARI

Bu özelliğe sahip öğeler, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY intent'lerini ele alma hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.

Eyaletler Tür Açıklama
color Nesne

Zorunludur.

Cihazda şu anda kullanılan renk ayarı.
Aşağıdaki öğelerden birini içerir:
0 Nesne

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

Zorunludur.

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

RGB renk spektrumu desteği.
spectrumRgb Tamsayı

Zorunludur.

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

HSV renk spektrumu desteği.
spectrumHsv Nesne

Zorunludur.

Spektral 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 ne? (Magenta)

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

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

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

Cihaz KOMUTLARI

Bu özelliğe sahip cihazlar, EXECUTE işlemi kapsamında aşağıdaki komutlara yanıt verebilir. EXECUTE amaçlarının ele alınması hakkında daha fazla bilgi edinmek için Niyet karşılama bölümüne bakın.

action.devices.commands.ColorAbsolute

Mutlak renk değerini ayarlayın.

Parametreler

Parametreler Tür 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 Tamsayı

Zorunludur.

Kelvin cinsinden sıcaklık değeri. Ayrıntılar için RGB, HSV ve renk sıcaklığı başlıklı makaleyi inceleyin.
1 Nesne

RGB renk spektrumu desteği.
spectrumRGB Tamsayı

Zorunludur.

Ondalık tam sayı olarak Spectrum RGB değerini girin. Ayrıntılar için RGB, HSV ve renk sıcaklığı başlıklı makaleyi inceleyin.
2 Nesne

HSV renk spektrumu desteği.
spectrumHSV Nesne

Zorunludur.

Spektral HSV değeri. Ayrıntılar için RGB, HSV ve renk sıcaklığı başlıklı makaleyi inceleyin.
hue Number

Ton.
saturation Number

Doygunluk.
value Number

Değer.

Örnekler

Işığı sıcak beyaz hale getirin.

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

Işığı eflatun yapın.

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

Işığı eflatun yap.

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

Komut ve durum parametreleri arasındaki parametre adlarının biraz farklı olduğunu unutmayın. 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

Hata ve istisnaların tam listesini inceleyin.