Smart Home ColorSetting Trait Schema

action.devices.traits.ColorSetting: Bu özellik, renk veya renk sıcaklığı 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) üçlüsü olarak gösterir. RGB, varsayılan renk modelidir. Herhangi bir RGB üçlüsü, üçlü için birleştirilmiş onaltılık değerlere eşdeğer bir onaltılık kod olarak gösterilebilir. Örneğin, "mavi" (0, 0, 255) ve #0000FF'dir. RGB renk alanındaki herhangi bir değeri kullanabilirsiniz. Yani x, y, z değerleri [0, 255] aralığında olan RGB(x, y, z) değerini kullanabilirsiniz.

HSV, renkleri (ton, doygunluk, değer) üçlüsü olarak gösterir. HSV'deki herhangi bir renk değeri RGB'ye, RGB'deki herhangi bir renk değeri de HSV'ye dönüştürülebilir. Ton, [0, 360) derece aralığındadır (360 derece, 0 dereceye döndüğü için hariçtir). Doygunluk ve değer, [0.0, 1.0] aralığındaki kayan sayılarla gösterilir.

Renk sıcaklığı, bazı renkleri Kelvin cinsinden negatif olmayan ondalık değerler olarak gösterir. Bu özellik, "soğuk beyaz" veya "kapalı hava 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ığında olup sabit Kelvin değerine sahip geleneksel ışıklara karşılık gelir. Renk sıcaklığı, doğrusal bir ölçek ve RGB/HSV tam spektrum renk modellerinin bir alt kümesidir. Bazı örnek sıcaklıklar ve karşılık gelen renk adları için aşağıdaki tabloya bakın.

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.

Örnekler

Hem RGB spektrum renk modelini hem de renk sıcaklığını destekleyen bir 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 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.

Örnekler

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

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

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

{
  "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ı ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

action.devices.commands.ColorAbsolute

Mutlak renk değerini ayarlayın.

Parametreler

Örnekler

Işığın rengini 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
      }
    }
  }
}

Parametre adlarının, komut ve durum parametreleri arasında biraz farklılık gösterdiğini unutmayın. Bu, kullanımdan kaldırılan ColorSpectrum ve ColorTemperature özellikleri için durum parametreleriyle çakışmaları önler.

Örnek ifadeler

Cihaz HATALARI