مخطّط سمات إعداد الألوان في المنزل الذكي

action.devices.traits.ColorSetting - تنطبق هذه السمة على الأجهزة، مثل المصابيح الذكية، التي يمكن أن تغيّر اللون أو درجة حرارة الألوان.

RGB وHSV ودرجة حرارة الألوان

وتمثل ألوان نموذج أحمر أخضر أزرق ألوانًا ثلاثية (أحمر وأخضر وأزرق). إنّ نموذج أحمر أخضر أزرق هو نموذج الألوان التلقائي. ويمكن تمثيل أي حزمة ثلاثية الأبعاد بنموذج أحمر أخضر أزرق كرمز سداسي عشري، وهو ما يعادل القيم السداسية العشرية للتسلسل الثلاثي. على سبيل المثال، "أزرق" هو (0، 0، 255) و #0000FF. يمكنك استخدام أي قيمة ضمن مساحة اللون الأحمر والأخضر والأزرق، أي RGB(x, y, z) حيث x، y، z ضمن النطاق [0، 255]، بما في ذلك القيم الواقعة بينهما.

يمثل HSV الألوان كثلاثة ألوان (درجة تدرج، تشبع، قيمة). ويمكن تحويل أي قيمة لونية في HSV إلى نموذج أحمر أخضر أزرق، والعكس صحيح. يبلغ نطاق Hue [0, 360) درجة (باستثناء 360 درجة، بما أنها تلتف حول 0 درجة تقريبًا). يتم تمثيل تشبُّع القيمة والقيمة بـ عوامات في النطاق [0.0، 1.0].

تمثّل درجة حرارة الألوان بعض الألوان كقيم عشرية غير سالبة بالكلفن. تصف هذه السمة المصابيح "البيضاء" أو "الدافئة"، مع استخدام أسماء ألوان مثل "أبيض بارد" أو "ضوء الشمس ملبّد بالغيوم". عادةً ما يكون للمصابيح الذكية التي تدعم درجة حرارة الألوان نطاق [2000, 9000] كلفن، وهو ما يتوافق مع المصابيح التقليدية التي تستخدم درجة حرارة ثابتة بالكلفن. درجة حرارة الألوان عبارة عن مقياس خطي ومجموعة فرعية من نماذج ألوان RGB/HSV الكاملة الطيف. يمكنك الاطّلاع على الجدول أدناه لمعرفة بعض أمثلة درجات الحرارة وأسماء الألوان المقابلة.

درجة الحرارة (كلفن)	اسم اللون
2,000	ضوء الشموع
2500	أبيض دافئ للغاية
3,000	أبيض ناعم، أبيض صباحي، أبيض للقراءة
4,000	أبيض بارد
5,000	ضوء النهار، أبيض
6000	أبيض زهري
7000	غائم وضوء نهاري ودخان أبيض
8000	طقس غائم أزرق
9000	سماء زرقاء

الجهاز ATTRIBUTES

ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن السمات التالية كجزء من عملية SYNC. لمزيد من المعلومات حول التعامل مع إجراءات SYNC، يُرجى الاطّلاع على تنفيذ الإجراء.

السمات	النوع	الوصف
commandOnlyColorSetting	منطقي	(القيمة التلقائية: false) تشير إلى ما إذا كان الجهاز يتيح استخدام اتصال أحادي الاتجاه (صحيح) أو ثنائي الاتجاه (خطأ). اضبط هذه السمة على "صحيح" إذا تعذّر على الجهاز الرد على طلب QUERY أو حالة التقرير لهذه السمة.
يحتوي على أي من العناصر التالية:
0	العنصر	دعم نموذج الألوان.
colorModel	سلسلة	مطلوبة. نموذج ألوان طيف كامل متوافق مع الجهاز. القيم المسموح بها: rgb hsv
1	العنصر	دعم درجة حرارة الألوان.
colorTemperatureRange	العنصر	مطلوبة. نطاق درجة حرارة اللون المتوافق بالكلفن.
temperatureMinK	عدد صحيح	مطلوبة. الحد الأدنى المعتمد لدرجة حرارة الألوان بالكلفن.
temperatureMaxK	عدد صحيح	مطلوبة. الحد الأقصى لدرجة حرارة اللون المسموح بها بالكلفن.

أمثلة

الجهاز الذي يتوافق مع كل من نموذج ألوان الطيف RGB ودرجة حرارة الألوان.

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

الجهاز الذي لا يتوافق إلا مع نموذج ألوان طيف HSV

{
  "colorModel": "hsv"
}

الجهاز الذي يتيح درجة حرارة الألوان فقط.

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

الجهاز الذي يتوافق فقط مع أوامر نماذج ألوان HSV.

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

حالة الجهاز STATES

ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن الحالات التالية كجزء من عملية QUERY. لمزيد من المعلومات حول التعامل مع إجراءات QUERY، يُرجى الاطّلاع على تنفيذ الإجراء.

الولايات	النوع	الوصف
color	العنصر	مطلوبة. إعداد اللون الحالي المُستخدَم حاليًا على الجهاز.
يحتوي على أحد العناصر التالية:
0	العنصر	دعم درجة حرارة الألوان.
temperatureK	عدد صحيح	مطلوبة. قيمة درجة الحرارة بالكلفن.
1	العنصر	دعم طيف ألوان نموذج أحمر أخضر أزرق.
spectrumRgb	عدد صحيح	مطلوبة. قيمة RGB لـ Spectrum كعدد صحيح عشري.
2	العنصر	دعم ألوان طيف HSV.
spectrumHsv	العنصر	مطلوبة. قيمة HSV لـ Spectrum.
hue	Number	Hue.
saturation	Number	تشبُّع اللون
value	Number	القيمة.

أمثلة

ما هو لون الإضاءة؟ (أبيض دافئ)

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

ما هو لون الإضاءة؟ (أحمر أرجواني)

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

ما هو لون الإضاءة؟ (أحمر أرجواني)

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

مفاتيح COMMAND

قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر التالية كجزء من عملية EXECUTE. لمزيد من المعلومات حول التعامل مع إجراءات EXECUTE، يُرجى الاطّلاع على تنفيذ الإجراء.

action.devices.commands.ColorAbsolute

تعيين قيمة اللون المطلقة.

المَعلمات

المَعلمات	النوع	الوصف
color	العنصر	مطلوبة. اللون المطلوب ضبطه.
name	سلسلة	تم تحليل اسم اللون من أمر المستخدم، وقد لا يكون متاحًا دائمًا (أي عند استخدام أوامر نسبية).
يحتوي على أحد العناصر التالية:
0	العنصر	دعم درجة حرارة الألوان.
temperature	عدد صحيح	مطلوبة. قيمة درجة الحرارة بالكلفن.
1	العنصر	دعم طيف ألوان نموذج أحمر أخضر أزرق.
spectrumRGB	عدد صحيح	مطلوبة. قيمة RGB لـ Spectrum كعدد صحيح عشري.
2	العنصر	دعم ألوان طيف HSV.
spectrumHSV	العنصر	مطلوبة. قيمة HSV لـ Spectrum.
hue	Number	Hue.
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

أخطاء الجهاز

يمكنك الاطلاع على القائمة الكاملة للأخطاء والاستثناءات.