סכימת תכונות של הגדרות צבעים לבית חכם
action.devices.traits.ColorSetting
– התכונה הזו חלה על מכשירים, כמו נורות חכמות, שיכולים לשנות את הצבע או את טמפרטורת הצבעים.
RGB, HSV וטמפרטורת הצבע
RGB מייצג את הצבעים כשלשה (אדום, ירוק, כחול). RGB הוא מודל הצבעים שמוגדר כברירת מחדל. כל שלשה RGB יכולה להיות מיוצגת כקוד הקסדצימלי, שווה ערך לערכים ההקסדצימליים של השלשה המשורשרת. לדוגמה, "כחול" הוא (0, 0, 255) ו-#0000FF. אפשר להשתמש בכל ערך בטווח הצבעים של ה-RGB. כלומר, RGB(x, y, z) כאשר x, y, z נמצאים בטווח של [0, 255] כולל.
HSV מייצג את הצבעים כשלשה (גוון, רוויה, ערך). אפשר להמיר כל ערך של צבע ב-HSV ל-RGB, ולהפך. לגוון יש טווח של [0, 360) מעלות (לא כולל 360, כי הוא עוטף ל-0 מעלות). הרוויה וערך מיוצגים על ידי צפים בטווח [0.0, 1.0].
טמפרטורת צבע מייצגת צבעים מסוימים כערכים עשרוניים לא שליליים בקלווין. מאפיין זה מתאר מנורות 'לבנות' או 'חמימות', עם שמות צבעים כמו 'לבן קריר' או 'אור יום מעונן'. לנורות חכמות שתומכות בטמפרטורת צבע יש בדרך כלל טווח של [2000, 9000] קלווין, שמתאים לנורות רגילות עם רמת קלווין קבועה. טמפרטורת הצבעים היא קנה מידה לינארי וקבוצת משנה של מודלים של צבעי ספקטרום RGB/HSV. בטבלה שלמטה מוצגות טמפרטורות לדוגמה ושמות הצבעים התואמים.
טמפרטורה (קלווין) | שם הצבע |
---|---|
2,000 | אור נרות |
2,500 | לבן חם במיוחד |
3,000 | לבן רך, לבן בוקר, לבן קריאה |
4,000 | לבן קר |
5,000 | אור יום, לבן |
6000 | לבן פרחוני |
7000 | אור יום מעונן, עשן לבן |
8000 | כחול מעונן |
9000 | שמיים כחולים |
מאפייני המכשיר
מכשירים עם התכונה הזו עשויים לדווח על המאפיינים הבאים כחלק מהפעולה SYNC
. מידע נוסף על טיפול באובייקטים מסוג SYNC
זמין במאמר מילוי אובייקטים של Intent.
מאפיינים | סוג | תיאור |
---|---|---|
commandOnlyColorSetting |
בוליאני |
(ברירת המחדל: הערך הזה מציין אם המכשיר תומך בתקשורת חד-כיוונית (true) או בתקשורת דו-כיוונית (לא נכונה). יש להגדיר את המאפיין הזה כ-True אם המכשיר לא יכול להגיב ל-Intent QUERY או למצב דיווח של התכונה הזו. |
מכיל אחד מהפריטים הבאים: | ||
0
|
אובייקט |
תמיכה במודלי צבעים. |
colorModel |
String |
חובה. מודל צבע ספקטרום מלא שנתמך על ידי המכשיר. ערכים נתמכים:
|
1
|
אובייקט |
תמיכה בטמפרטורת צבע. |
colorTemperatureRange |
אובייקט |
חובה. טווח טמפרטורות צבעים נתמך בקלווין. |
temperatureMinK |
Integer |
חובה. טמפרטורת הצבע המינימלית הנתמכת בקלווין. |
temperatureMaxK |
Integer |
חובה. טמפרטורת הצבע המקסימלית הנתמכת בקלווין. |
דוגמאות
מכשיר שתומך במודל צבעים של ספקטרום RGB וגם בטמפרטורת צבעים.
{ "colorModel": "rgb", "colorTemperatureRange": { "temperatureMinK": 2000, "temperatureMaxK": 9000 } }
מכשיר שתומך רק במודל צבע ספקטרום של HSV
{ "colorModel": "hsv" }
מכשיר שתומך רק בטמפרטורת צבע
{ "colorTemperatureRange": { "temperatureMinK": 2000, "temperatureMaxK": 9000 } }
מכשיר שתומך רק בפקודות למודל צבעים של HSV.
{ "colorModel": "hsv", "commandOnlyColorSetting": true }
מכשיר STATES
ישויות עם התכונה הזו עשויות לדווח על המצבים הבאים כחלק מהפעולה QUERY
. מידע נוסף על טיפול באובייקטים מסוג QUERY
זמין במאמר מילוי אובייקטים של Intent.
מדינות | סוג | תיאור |
---|---|---|
color |
אובייקט |
חובה. הגדרת הצבע הנוכחית נמצאת בשימוש במכשיר. |
מכיל אחד מהפריטים הבאים: | ||
0
|
אובייקט |
תמיכה בטמפרטורת צבע. |
temperatureK |
Integer |
חובה. ערך הטמפרטורה בקלווין. |
1
|
אובייקט |
תמיכה בספקטרום הצבעים RGB. |
spectrumRgb |
Integer |
חובה. ספקטרום של ערך RGB כמספר שלם עשרוני. |
2
|
אובייקט |
תמיכה בספקטרום צבעים של HSV. |
spectrumHsv |
אובייקט |
חובה. ערך HSV ב-Spectrum. |
hue |
מספר |
גוון. |
saturation |
מספר |
רוויה. |
value |
מספר |
ערך. |
דוגמאות
מה צבע התאורה? (לבן חם)
{ "color": { "temperatureK": 3000 } }
מה צבע התאורה? (מג'נטה)
{ "color": { "spectrumRgb": 16711935 } }
מה צבע התאורה? (מג'נטה)
{ "color": { "spectrumHsv": { "hue": 300, "saturation": 1, "value": 1 } } }
COMMANDS של מכשיר
מכשירים עם התכונה הזו עשויים להגיב לפקודות הבאות כחלק מהפעולה EXECUTE
. מידע נוסף על טיפול באובייקטים מסוג EXECUTE
זמין במאמר מילוי אובייקטים של Intent.
action.devices.commands.ColorAbsolute
מגדירים את ערך הצבע המוחלט.
פרמטרים
פרמטרים | סוג | תיאור |
---|---|---|
color |
אובייקט |
חובה. צבע להגדרה. |
name |
String |
שם הצבע שנותח מהפקודה של המשתמש. יכול להיות שלא תמיד יהיה זמין (כלומר כשמשתמשים בפקודות יחסיות). |
מכיל אחד מהפריטים הבאים: | ||
0
|
אובייקט |
תמיכה בטמפרטורת צבע. |
temperature |
Integer |
חובה. ערך הטמפרטורה בקלווין. פרטים נוספים זמינים במאמר RGB , HSV וטמפרטורת צבע. |
1
|
אובייקט |
תמיכה בספקטרום הצבעים RGB. |
spectrumRGB |
Integer |
חובה. ספקטרום של ערך RGB כמספר שלם עשרוני. פרטים נוספים זמינים במאמר RGB , HSV וטמפרטורת צבע. |
2
|
אובייקט |
תמיכה בספקטרום צבעים של HSV. |
spectrumHSV |
אובייקט |
חובה. ערך HSV ב-Spectrum. פרטים נוספים זמינים במאמר RGB , HSV וטמפרטורת צבע. |
hue |
מספר |
גוון. |
saturation |
מספר |
רוויה. |
value |
מספר |
ערך. |
דוגמאות
יוצרים צבע לבן בהיר וחום.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Warm White", "temperature": 3000 } } }
יוצרים את המג'נטה הבהיר.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Magenta", "spectrumRGB": 16711935 } } }
יוצרים את המג'נטה הבהיר.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Magenta", "spectrumHSV": { "hue": 300, "saturation": 1, "value": 1 } } } }
שימו לב ששמות הפרמטרים משתנים מעט בין הפרמטרים של הפקודה ומצב. כך אפשר למנוע התנגשויות עם הפרמטרים של המצב עבור התכונות ColorSpectrum ו-ColorTemperature שהוצאו משימוש.
Command | ארץ |
---|---|
temperature |
temperatureK |
spectrumRGB |
spectrumRgb |
spectrumHSV |
spectrumHsv |
ביטויים לדוגמה
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