סכימת מאפיינים של הגדרת צבעים לבית חכם

‫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] קלווין, שמתאים לנורות רגילות עם קלווין קבוע. ‫Color temperature is a linear scale and a subset of the RGB/HSV full spectrum color models. בטבלה הבאה מוצגות כמה דוגמאות לטמפרטורות ולשמות הצבעים התואמים.

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

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

דוגמאות

מכשיר שתומך גם במודל צבעי ספקטרום RGB וגם בטמפרטורת צבעים.

{
  "colorModel": "rgb",
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

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

{
  "colorModel": "hsv"
}

מכשיר שתומך רק בטמפרטורת צבע.

{
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

מכשיר שתומך רק בפקודות של מודל צבע HSV.

{
  "colorModel": "hsv",
  "commandOnlyColorSetting": true
}

מצבי המכשיר

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

דוגמאות

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

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

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

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

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

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

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

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

action.devices.commands.ColorAbsolute

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

פרמטרים

דוגמאות

Make the light warm white.

{
  "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 שהוצאו משימוש.

דוגמאות לניסוחים

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