स्मार्ट होम कलरसेटिंग एट्रिब्यूट स्कीमा

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

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

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

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

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

तापमान (केल्विन)	रंग का नाम
2,000	कैंडल लाइट
2500	अल्ट्रा वॉर्म व्हाइट
3000	सॉफ़्ट व्हाइट, मॉर्निंग व्हाइट, रीडिंग व्हाइट
4,000	कूल व्हाइट
5,000	डे लाइट, व्हाइट
6000	फ़्लोरल व्हाइट
7000	दिन की रोशनी में बादलों से घिरा हुआ सफ़ेद धुआं,
8000	ब्लू ओवरकास्ट
9000	नीला आकाश

डिवाइस ATTRIBUTES

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

विशेषताएं	टाइप	ब्यौरा
commandOnlyColorSetting	बूलियन	(डिफ़ॉल्ट: false) यह बताता है कि डिवाइस पर एकतरफ़ा (सही) या दोतरफ़ा (गलत) कम्यूनिकेशन की सुविधा काम करती है. अगर डिवाइस इस एट्रिब्यूट के लिए, QUERY इंटेंट या रिपोर्ट की स्थिति का जवाब नहीं दे सकता, तो इस एट्रिब्यूट को 'सही' पर सेट करें.
इसमें इनमें से कोई भी आइटम शामिल होता है:
0	ऑब्जेक्ट	कलर मॉडल की सुविधा.
colorModel	स्ट्रिंग	ज़रूरी है. इस डिवाइस पर काम करने वाला फ़ुल स्पेक्ट्रम कलर मॉडल. इस्तेमाल की जा सकने वाली वैल्यू: rgb hsv
1	ऑब्जेक्ट	कलर टेंपरेचर की सुविधा.
colorTemperatureRange	ऑब्जेक्ट	ज़रूरी है. केल्विन में काम करने वाली कलर टेंपरेचर रेंज.
temperatureMinK	Integer	ज़रूरी है. केल्विन में कम से कम समर्थित रंग तापमान.
temperatureMaxK	Integer	ज़रूरी है. केल्विन में ज़्यादा से ज़्यादा समर्थित रंग तापमान.

उदाहरण

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

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

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

{
  "colorModel": "hsv"
}

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

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

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

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

डिवाइस की स्थितियां

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

राज्य	टाइप	ब्यौरा
color	ऑब्जेक्ट	ज़रूरी है. रंग की मौजूदा सेटिंग, जो फ़िलहाल डिवाइस पर इस्तेमाल की जा रही है.
इसमें इनमें से कोई एक आइटम शामिल होता है:
0	ऑब्जेक्ट	कलर टेंपरेचर की सुविधा.
temperatureK	Integer	ज़रूरी है. केल्विन में तापमान का मान.
1	ऑब्जेक्ट	कलर आरजीबी स्पेक्ट्रम काम करता है.
spectrumRgb	Integer	ज़रूरी है. दशमलव पूर्णांक के तौर पर स्पेक्ट्रम आरजीबी वैल्यू.
2	ऑब्जेक्ट	कलर एचएसवी स्पेक्ट्रम काम करता है.
spectrumHsv	ऑब्जेक्ट	ज़रूरी है. स्पेक्ट्रम एचएसवी वैल्यू.
hue	Number	ह्यू.
saturation	Number	रंग गहरा या फ़ीका करें.
value	Number	वैल्यू.

उदाहरण

लाइट का रंग क्या है? (वॉर्म व्हाइट)

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

लाइट का रंग क्या है? (मैजेंटा)

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

लाइट का रंग क्या है? (मैजेंटा)

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

डिवाइस COMMANDS

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

action.devices.commands.ColorAbsolute

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

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
color	ऑब्जेक्ट	ज़रूरी है. सेट करने के लिए रंग.
name	स्ट्रिंग	वह रंग नाम जिसे उपयोगकर्ता के निर्देश से पार्स किया गया है; हो सकता है कि यह हमेशा उपलब्ध न हो (जैसे कि मिलते-जुलते निर्देशों का इस्तेमाल करते समय).
इसमें इनमें से कोई एक आइटम शामिल होता है:
0	ऑब्जेक्ट	कलर टेंपरेचर की सुविधा.
temperature	Integer	ज़रूरी है. केल्विन में तापमान का मान. ज़्यादा जानकारी के लिए, आरजीबी, एचएसवी, और कलर टेंपरेचर देखें.
1	ऑब्जेक्ट	कलर आरजीबी स्पेक्ट्रम काम करता है.
spectrumRGB	Integer	ज़रूरी है. दशमलव पूर्णांक के तौर पर स्पेक्ट्रम आरजीबी वैल्यू. ज़्यादा जानकारी के लिए, आरजीबी, एचएसवी, और कलर टेंपरेचर देखें.
2	ऑब्जेक्ट	कलर एचएसवी स्पेक्ट्रम काम करता है.
spectrumHSV	ऑब्जेक्ट	ज़रूरी है. स्पेक्ट्रम एचएसवी वैल्यू. ज़्यादा जानकारी के लिए, आरजीबी, एचएसवी, और कलर टेंपरेचर देखें.
hue	Number	ह्यू.
saturation	Number	रंग गहरा या फ़ीका करें.
value	Number	वैल्यू.

उदाहरण

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

{
  "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 traits के स्टेट पैरामीटर से होने वाले टकराव से बचा जा सकता है.

आदेश	स्थिति
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

डिवाइस ERRORS

गड़बड़ियों और अपवादों की पूरी सूची देखें.