הסכימה של מאפיין ColorSetting לבית חכם

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

טמפרטורת הצבע מייצגת חלק מהצבעים כערכים עשרוניים לא שליליים בקלווין. במאפיין הזה מתוארים אורות "לבן" או "חמים", עם שמות של צבעים כמו 'לבן קריר' או 'אור יום מעונן'. מנורות חכמות שתומכות בטמפרטורת צבע בדרך כלל כוללות טווח של 2,000 עד 9,000 קלווין, שתואם למנורות רגילות עם קלווין קבוע. טמפרטורת הצבע היא סולם לינארי וקבוצת משנה של מודלים של צבע בספקטרום מלא RGB/HSV. בטבלה הבאה מפורטות כמה דוגמאות לטמפרטורות ולשמות הצבעים המתאימים.

טמפרטורה (קלווין) שם הצבע
2000אור נרות
2,500לבן חם במיוחד
3000לבן עדין, לבן בוקר, לבן לקריאה
4000לבן קריר
5000אור יום, לבן
6000לבן פרחוני
7000אור יום מעונן, עשן לבן
8000כחול מעונן
9000Blue Sky

מאפייני המכשיר

מכשירים עם המאפיין הזה עשויים לדווח על המאפיינים הבאים כחלק מהפעולה SYNC. למידע נוסף על טיפול בכוונות SYNC, ראו ביצוע כוונות.

מאפיינים סוג תיאור
commandOnlyColorSetting בוליאני

(ברירת המחדל: false)

מציינת אם המכשיר תומך בתקשורת חד-כיוונית (true) או בתקשורת דו-כיוונית (false). מגדירים את המאפיין הזה כ-true אם המכשיר לא יכול להגיב לכוונה מסוג QUERY או לדיווח על המצב של המאפיין הזה.
מכיל את אחד מהפריטים הבאים:
0 מפגע

תמיכה במודל צבע.
colorModel String

חובה.

מודל הצבעים של הספקטרום המלא שנתמך על ידי המכשיר.

ערכים נתמכים:

rgb
hsv
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
}

מצבי המכשיר

ישויות עם המאפיין הזה יכולות לדווח על המצבים הבאים כחלק מהפעולה QUERY. למידע נוסף על טיפול בכוונות QUERY, ראו ביצוע כוונות.

מדינות סוג תיאור
color מפגע

חובה.

הגדרת הצבע הנוכחית שבה נעשה שימוש במכשיר.
מכיל אחד מהפריטים הבאים:
0 אובייקט

תמיכה בטמפרטורת צבע.
temperatureK Integer

חובה.

ערך הטמפרטורה בקלווין.
1 מפגע

תמיכה בטווח הצבעים RGB.
spectrumRgb Integer

חובה.

ערך RGB של ספקטרום כמספר שלם עשרוני.
2 אובייקט

תמיכה בטווח הצבעים HSV.
spectrumHsv אובייקט

חובה.

ערך HSV של הספקטרום.
hue מספר

גוון.
saturation מספר

רוויה.
value מספר

ערך.

דוגמאות

מהו צבע התאורה? (לבן חם)

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

מהו צבע התאורה? (ורוד מג'נטה)

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

מה הצבע של המנורה? (מגנטה)

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

פקודות למכשיר

מכשירים עם התכונה הזו עשויים להגיב לפקודות הבאות כחלק מהפעולה EXECUTE. למידע נוסף על טיפול בכוונות EXECUTE, ראו ביצוע כוונות.

action.devices.commands.ColorAbsolute

מגדירים את ערך הצבע המוחלט.

פרמטרים

פרמטרים סוג תיאור
color מפגע

חובה.

הצבע שרוצים להגדיר.
name String

שם הצבע שנותח מהפקודה של המשתמש. יכול להיות שהוא לא תמיד יהיה זמין (כלומר, כשמשתמשים בפקודות יחסיות).
מכיל אחד מהפריטים הבאים:
0 אובייקט

תמיכה בטמפרטורת צבע.
temperature Integer

חובה.

ערך הטמפרטורה בקלווין. פרטים נוספים זמינים במאמר RGB, HSV וטמפרטורת צבעים.
1 אובייקט

תמיכה בטווח הצבעים RGB.
spectrumRGB Integer

חובה.

ערך RGB של ספקטרום כמספר שלם עשרוני. פרטים נוספים זמינים במאמר RGB, HSV וטמפרטורת צבעים.
2 אובייקט

תמיכה בטווח הצבעים HSV.
spectrumHSV אובייקט

חובה.

ערך HSV של הספקטרום. פרטים נוספים זמינים במאמר 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 שהוצאו משימוש.

פקודה מדינה
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

שגיאות במכשיר

הרשימה המלאה של השגיאות והחריגות