Akıllı Ev Renk Ayarı Özellik Şeması
action.devices.traits.ColorSetting
- Bu özellik, renk veya renk sıcaklığını değiştirebilen akıllı ışık gibi cihazlar için geçerlidir.
RGB, HSV ve renk sıcaklığı
RGB, renkleri (kırmızı, yeşil, mavi) üçlü olarak gösterir. RGB, varsayılan renk modelidir. Herhangi bir RGB üçlüsü, birleştirilen üçlü değeri için onaltılık değerlere eşdeğer bir onaltılık kod olarak temsil edilebilir. Örneğin, "mavi" (0, 0, 255) ve #0000FF'tir. RGB renk alanı içinde herhangi bir değeri kullanabilirsiniz (ör. RGB(x, y, z). Burada x, y, z, [0, 255] aralığındadır (dahil).
HSV, renkleri bir ton, doygunluk, değer üçlüsü olarak temsil eder. HSV'deki tüm renk değerleri RGB'ye dönüştürülür ve bunun tersi de geçerlidir. Ton [0, 360] derece aralığındadır (yaklaşık 0 dereceye yuvarlandığı için 360 hariç). Doygunluk ve değer [0.0, 1.0] aralığındaki kayan öğelerle temsil edilir.
Renk sıcaklığı, bazı renkleri Kelvin cinsinden negatif olmayan ondalık değerler olarak gösterir. Bu özellik, "soğuk beyaz" veya "üstü kapalı gün ışığı" gibi renk adlarıyla "beyaz" veya "ılık" ışıkları tanımlar. Renk sıcaklığını destekleyen akıllı ışıklar genellikle [2000, 9000] Kelvin aralığına sahiptir ve sabit Kelvin kullanılan 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 karşılık gelen renk adları için aşağıdaki tabloya bakın.
Sıcaklık (Kelvin) | Renk Adı |
---|---|
2.000 | Mum Işığı |
2500 | Ultra Sıcak Beyaz |
3.000 | Yumuşak Beyaz, Sabah Beyazı, Okuma Beyazı |
4.000 | Soğuk Beyaz |
5.000 | Gün Işığı, Beyaz |
6.000 | Çiçek Beyazı |
7000 | Bulutlu Gün Işığı, Beyaz Duman |
8000 | Mavi Bulutlu |
9000 | Mavi 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 için Amaç karşılama bölümüne bakın.
Özellikler | Type | Açıklama |
---|---|---|
commandOnlyColorSetting |
Boole |
(Varsayılan: Cihazın tek yönlü (doğru) veya iki yönlü (yanlış) iletişimi destekleyip desteklemediğini belirtir. Cihaz, bu özellik için bir QUERY amacına veya Rapor Durumuna yanıt veremezse bu özelliği doğru olarak ayarlayın. |
Aşağıdaki öğelerden herhangi birini içerir: | ||
0
|
Nesne |
Renk modeli desteği. |
colorModel |
Dize |
Zorunludur. Cihaz tarafından desteklenen tam spektrumlu renk modeli. Desteklenen değerler:
|
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 spektrumlu 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 STATUS
Bu özelliğe sahip varlıklar, QUERY
işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY
amaçlarını işleme hakkında daha fazla bilgi için Amaç karşılama bölümüne bakın.
Eyaletler | Type | 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 |
Integer |
Zorunludur. Kelvin cinsinden sıcaklık değeri. |
1
|
Nesne |
Renk RGB spektrumu desteği. |
spectrumRgb |
Integer |
Zorunludur. RGB değerini ondalık sayı olarak seçin. |
2
|
Nesne |
Renkli HSV spektrum desteği. |
spectrumHsv |
Nesne |
Zorunludur. Spectrum HSV değeri. |
hue |
Number |
Ton. |
saturation |
Number |
Doygunluk. |
value |
Number |
Değer. |
Örnekler
Işık ne? (Sıcak Beyaz)
{ "color": { "temperatureK": 3000 } }
Işık ne? (Eflatun)
{ "color": { "spectrumRgb": 16711935 } }
Işık ne? (Eflatun)
{ "color": { "spectrumHsv": { "hue": 300, "saturation": 1, "value": 1 } } }
Cihaz Komisyonları
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 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 |
Dize |
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ığı başlıklı makaleye bakın. |
1
|
Nesne |
Renk RGB spektrumu desteği. |
spectrumRGB |
Integer |
Zorunludur. RGB değerini ondalık sayı olarak seçin. Ayrıntılar için RGB, HSV ve renk sıcaklığı başlıklı makaleye bakın. |
2
|
Nesne |
Renkli HSV spektrum desteği. |
spectrumHSV |
Nesne |
Zorunludur. Spectrum HSV değeri. Ayrıntılar için RGB, HSV ve renk sıcaklığı başlıklı makaleye bakın. |
hue |
Number |
Ton. |
saturation |
Number |
Doygunluk. |
value |
Number |
Değer. |
Örnekler
Işıkları beyaz sıcak yap.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Warm White", "temperature": 3000 } } }
Açık eflatun yapın.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Magenta", "spectrumRGB": 16711935 } } }
Açık eflatun yapın.
{ "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ı olduğunu unutmayın. Bu durum, kullanımdan kaldırılan ColorSpectrum ve ColorTemperature özellikleri için 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