Akıllı Ev ColorSettings Trait Ş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üsü olarak gösterir. RGB, varsayılan renk modelidir. Tüm RGB üçlüleri, birleştirilen üçlü örneğin onaltılık değerlerine eşdeğer olan bir on altılık kod olarak temsil edilebilir. Örneğin, "mavi" (0, 0, 255) ve #0000FF'dir. RGB renk alanında herhangi bir değeri kullanabilirsiniz; diğer bir deyişle, RGB(x, y, z) kullanılabilir. Burada x, y, z, [0, 255] aralığındadır (bu değerler dahil).
HSV, renkleri bir ton, doygunluk, değer üçlüsü olarak temsil eder. HSV'deki tüm renk değerleri RGB'ye (veya tersi) dönüştürülebilir. Tonu [0, 360] derece aralığındadır (yaklaşık 0 dereceye denk geldiği için 360 hariç). Doygunluk ve değer [0.0, 1.0] aralığındaki kayan sayılar ile gösterilir.
Renk sıcaklığı, Kelvin cinsinden bazı renkleri negatif olmayan ondalık değerler olarak gösterir. Bu özellik, "soğuk beyaz" veya "anlatımlı 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 değerine sahiptir ve sabit Kelvin özelliği olan 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ı |
---|---|
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 Kapalı |
9000 | Mavi Gökyüzü |
Cihaz ÖZELLİKLERİ
Bu özelliğe sahip cihazlar, SYNC
işleminin bir parçası olarak aşağıdaki özellikleri bildirebilir. SYNC
niyetlerini işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.
Özellikler | Tür | Açıklama |
---|---|---|
commandOnlyColorSetting |
Boole |
(Varsayılan: Cihazın tek yönlü (true) veya iki yönlü (false) iletişimin kullanılmasını destekleyip desteklemediğini belirtir. Cihaz, bu özellik için bir QUERY amacına veya rapor durumuna yanıt vermiyorsa bu özelliği "true" 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'de 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 durumu
Bu özelliğe sahip cihazlar, QUERY
işleminin bir parçası olarak aşağıdaki durumları bildirebilir. QUERY
niyetlerini işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.
Eyaletler | Tür | Açıklama |
---|---|---|
color |
Nesne |
Zorunludur. Cihazda kullanılmakta olan mevcut renk ayarı. |
Aşağıdaki öğelerden birini içerir: | ||
0
|
Nesne |
Renk sıcaklığı desteği. |
temperatureK |
Integer |
Zorunludur. Kelvin cinsinden sıcaklık. |
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şık ne kadar? (Sıcak Beyaz)
{ "color": { "temperatureK": 3000 } }
Işık ne kadar? (Magenta)
{ "color": { "spectrumRgb": 16711935 } }
Işık ne kadar? (Magenta)
{ "color": { "spectrumHsv": { "hue": 300, "saturation": 1, "value": 1 } } }
Cihaz FTC'leri
Bu özelliğe sahip cihazlar, EXECUTE
işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE
niyetlerini 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 | Tür | Açıklama |
---|---|---|
color |
Nesne |
Zorunludur. Ayarlanacak renk. |
name |
Dize |
Kullanıcının komutundan ayrıştırılan renk adı; her zaman kullanılamayabilir (yani 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. |
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şıkyı sıcak beyaz yapın.
{ "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, 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 sözler
de-DE
-
Stell die Farbe
der Lampe aufblau -
Stelle die Farbtemperatur auf
3000 Kelvin ein.
en-US
-
can you adjust
my lights color to4000 kelvins -
set
the lights toblue
es-ES
-
pon
azul la luz de la cocina -
pon
la luz a2000 k de temperatura de color
fr-FR
-
Allume
la lampe de la chambre à3500 kelvins . -
mets
les lampes enrose dansla chambre
hi-IN
-
तुम
लाइट कोब्लू कर दो -
लैम्प 2000 केल्विन पर लगाओ।
it-IT
-
Imposta
la lampada a2000 K . -
metti
la luce gialla
ja-JP
-
照明 の色を青 にして -
照明 の色温度を5000K にセットして
ko-KR
-
조명 색깔흰색 으로 바꿔 줘 -
주방 전등 색 온도를5000 켈빈 으로 설정해
nl-NL
-
Zet
de keukenlamp op2000 Kelvin . -
maak
het licht rood
pt-BR
-
Colocar
a lâmpada em2000 K . -
Define
a lâmpada para2000 K . -
colocar
a luz da sala emazul -
põe
a luz da sala avermelho
sv-SE
-
Ställ in
lampan på2000 Kelvin -
tänd
blått ljus i köket