स्मार्ट होम ColorSetting ट्रेट का स्कीमा

action.devices.traits.ColorSetting - यह ट्रेट, स्मार्ट लाइट जैसे उन डिवाइसों पर लागू होती है जिनके रंग या रंग के तापमान में बदलाव किया जा सकता है.

आरजीबी, एचएसवी, और कलर टेंपरेचर

आरजीबी, रंगों को (लाल, हरा, नीला) ट्रिपलेट के तौर पर दिखाता है. आरजीबी, डिफ़ॉल्ट कलर मॉडल है. किसी भी आरजीबी ट्रिपलेट को हेक्सकोड के तौर पर दिखाया जा सकता है. यह ट्रिपलेट के लिए हेक्साडेसिमल वैल्यू के बराबर होता है. उदाहरण के लिए, "नीला" (0, 0, 255) और #0000FF है. आरजीबी कलर स्पेस में मौजूद किसी भी वैल्यू का इस्तेमाल किया जा सकता है. इसका मतलब है कि आरजीबी(x, y, z) में x, y, z की वैल्यू [0, 255] के बीच होनी चाहिए.

HSV, रंगों को (ह्यू, सैचुरेशन, वैल्यू) ट्रिपलेट के तौर पर दिखाता है. एचएसवी में मौजूद किसी भी रंग की वैल्यू को आरजीबी में बदला जा सकता है. इसके उलट, आरजीबी में मौजूद किसी भी रंग की वैल्यू को एचएसवी में बदला जा सकता है. ह्यू की रेंज [0, 360) डिग्री होती है. इसमें 360 डिग्री शामिल नहीं होता, क्योंकि यह 0 डिग्री पर रैप हो जाता है. सैचुरेशन और वैल्यू को [0.0, 1.0] रेंज में फ़्लोट के तौर पर दिखाया जाता है.

कलर टेंपरेचर, कुछ रंगों को केल्विन में, शून्य से बड़ी दशमलव वैल्यू के तौर पर दिखाता है. इस एट्रिब्यूट में "सफ़ेद" या "गर्म" रोशनी के बारे में बताया जाता है. इसमें रंग के नाम शामिल होते हैं, जैसे कि "कूल व्हाइट" या "बादल वाला दिन." कलर टेंपरेचर की सुविधा देने वाली स्मार्ट लाइटों का कलर टेंपरेचर आम तौर पर [2000, 9000] केल्विन होता है. यह केल्विन की तय वैल्यू वाली पारंपरिक लाइटों के बराबर होता है. कलर टेंपरेचर, एक लीनियर स्केल होता है. साथ ही, यह आरजीबी/एचएसवी फ़ुल स्पेक्ट्रम कलर मॉडल का सबसेट होता है. यहां दी गई टेबल में, तापमान के कुछ उदाहरण और उनसे जुड़े कलर के नाम दिए गए हैं.

डिवाइस की ATTRIBUTES

इस ट्रेट वाले डिवाइस, SYNC ऑपरेशन के तहत इन एट्रिब्यूट की जानकारी दे सकते हैं. SYNC इंटेंट को मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट फ़ुलफ़िलमेंट देखें.

उदाहरण

ऐसा डिवाइस जो आरजीबी स्पेक्ट्रम कलर मॉडल और कलर टेम्परेचर, दोनों के साथ काम करता हो.

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

ऐसा डिवाइस जो सिर्फ़ एचएसवी स्पेक्ट्रम कलर मॉडल के साथ काम करता है.

{
  "colorModel": "hsv"
}

ऐसा डिवाइस जिसमें सिर्फ़ कलर टेंपरेचर को कंट्रोल करने की सुविधा हो.

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

ऐसा डिवाइस जो सिर्फ़ एचएसवी कलर मॉडल के निर्देशों के साथ काम करता है.

{
  "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

कलर की ऐब्सलूट वैल्यू सेट करें.

पैरामीटर

उदाहरण

लाइट को वॉर्म व्हाइट करो.

{
  "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 ट्रेट के लिए, स्टेट पैरामीटर के साथ टकराव नहीं होता.

सैंपल अटरेंस

डिवाइस से जुड़ी गड़बड़ियां