स्मार्ट होम 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] केल्विन के बीच होता है. यह कलर टेंपरेचर, तय केल्विन वाली सामान्य लाइटों के कलर टेंपरेचर से मेल खाता है. कलर टेंपरेचर एक लीनियर स्केल है और यह आरजीबी/एचएसवी फ़ुल स्पेक्ट्रम कलर मॉडल का सबसेट है. तापमान और उनसे जुड़े कलर के नाम के कुछ उदाहरणों के लिए, यहां दी गई टेबल देखें.

तापमान (केल्विन)	रंग का नाम
2000	कैंडल लाइट
2500	अल्ट्रा वॉर्म व्हाइट
3000	सॉफ़्ट व्हाइट, मॉर्निंग व्हाइट, रीडिंग व्हाइट
4000	कूल व्हाइट
5000	डे लाइट, व्हाइट
6000	फ़्लोरल व्हाइट
7000	बादल भरे दिन की रोशनी, धुएं जैसा सफ़ेद रंग
8000	ब्लू ओवरकास्ट
9000	ब्लू स्काई

डिवाइस ATTRIBUTES

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

विशेषताएं	टाइप	ब्यौरा
commandOnlyColorSetting	बूलियन	(डिफ़ॉल्ट: false) इससे पता चलता है कि डिवाइस पर एकतरफ़ा (सही) या दोतरफ़ा (गलत) कम्यूनिकेशन का इस्तेमाल किया जा सकता है या नहीं. अगर डिवाइस इस विशेषता के लिए QUERY इंटेंट या रिपोर्ट स्थिति का जवाब नहीं दे सकता, तो इस एट्रिब्यूट को 'सही' पर सेट करें.
इनमें से कोई आइटम शामिल हो:
0	ऑब्जेक्ट	कलर मॉडल के साथ काम करता है.
colorModel	String	ज़रूरी है. डिवाइस पर काम करने वाला फ़ुल स्पेक्ट्रम कलर मॉडल. इस्तेमाल की जा सकने वाली वैल्यू: 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
}

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

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

राज्य	टाइप	ब्यौरा
color	ऑब्जेक्ट	ज़रूरी है. डिवाइस पर अभी इस्तेमाल की जा रही रंग की मौजूदा सेटिंग.
इसमें इनमें से कोई एक आइटम शामिल है:
0	ऑब्जेक्ट	कलर टेंपरेचर सपोर्ट.
temperatureK	Integer	ज़रूरी है. केल्विन में तापमान की वैल्यू.
1	ऑब्जेक्ट	आरजीबी कलर स्पेक्ट्रम का इस्तेमाल किया जा सकता है.
spectrumRgb	Integer	ज़रूरी है. स्पेक्ट्रम आरजीबी वैल्यू को दशमलव पूर्णांक के तौर पर.
2	ऑब्जेक्ट	कलर एचएसवी स्पेक्ट्रम की सुविधा.
spectrumHsv	ऑब्जेक्ट	ज़रूरी है. स्पेक्ट्रम की HSV वैल्यू.
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	String	उपयोगकर्ता के निर्देश से पार्स किया गया रंग का नाम. ऐसा हो सकता है कि यह हमेशा उपलब्ध न हो, जैसे कि रिलेटिव निर्देशों का इस्तेमाल करते समय.
इसमें इनमें से कोई एक आइटम शामिल है:
0	ऑब्जेक्ट	कलर टेंपरेचर सपोर्ट.
temperature	Integer	ज़रूरी है. केल्विन में तापमान की वैल्यू. ज़्यादा जानकारी के लिए, आरजीबी, एचएसवी, और कलर टेंपरेचर देखें.
1	ऑब्जेक्ट	आरजीबी कलर स्पेक्ट्रम का इस्तेमाल किया जा सकता है.
spectrumRGB	Integer	ज़रूरी है. दशमलव पूर्णांक के रूप में स्पेक्ट्रम RGB मान. ज़्यादा जानकारी के लिए, आरजीबी, एचएसवी, और कलर टेंपरेचर देखें.
2	ऑब्जेक्ट	कलर एचएसवी स्पेक्ट्रम की सुविधा.
spectrumHSV	ऑब्जेक्ट	ज़रूरी है. स्पेक्ट्रम की HSV वैल्यू. ज़्यादा जानकारी के लिए, आरजीबी, एचएसवी, और कलर टेंपरेचर देखें.
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 ट्रैट के लिए, स्टेटस पैरामीटर के साथ टकराव से बचा जा सकता है.

कमांड	स्थिति
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

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

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