स्मार्ट होम कलर सेटिंग ट्रेल स्कीमा

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

आरजीबी, एचएसवी, और रंग का तापमान

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

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

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

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

डिवाइस की विशेषताएं

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

विशेषताएं	Type	जानकारी
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 इंटेंट को हैंडल करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.

राज्य	Type	जानकारी
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
    }
  }
}

डिवाइस के निर्देश

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

action.devices.commands.ColorAbsolute

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

पैरामीटर

पैरामीटर	Type	जानकारी
color	ऑब्जेक्ट	ज़रूरी है. सेट करने के लिए रंग.
name	String	उपयोगकर्ता के निर्देश से मिला रंग का नाम, हो सकता है कि हमेशा उपलब्ध न हो (जैसे कि मिलते-जुलते निर्देशों का इस्तेमाल करना).
इसमें, इनमें से कोई एक आइटम मौजूद है:
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 एट्रिब्यूट की स्थिति (पैरामीटर) के बीच टकराव नहीं होता.

Command	स्थिति
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

डिवाइस में गड़बड़ी

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