مخطط سمة إعدادات الألوان للمنزل المزوّد بأجهزة ذكية

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

نموذج أحمر أخضر أزرق (HSV) ونموذج أحمر أخضر أزرق ودرجة حرارة الألوان

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

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

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

درجة الحرارة (كلفن)	اسم اللون
2000	ضوء الشموع
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	عدد صحيح	يجب ملء هذا الحقل. الحد الأدنى لدرجة حرارة الألوان المتوافقة بالكلفن.
temperatureMaxK	عدد صحيح	يجب ملء هذا الحقل. الحد الأقصى لدرجة حرارة الألوان المتوافقة بالكلفن

أمثلة

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

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

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

{
  "colorModel": "hsv"
}

جهاز متوافق فقط مع درجة حرارة الألوان:

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

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

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

حالات الجهاز

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

الولايات	Type	الوصف
color	كائن	يجب ملء هذا الحقل. يتم استخدام إعداد اللون الحالي على الجهاز حاليًا.
تحتوي على أحد العناصر التالية:
0	كائن	إتاحة درجة حرارة الألوان
temperatureK	عدد صحيح	يجب ملء هذا الحقل. قيمة درجة الحرارة بالكلفن.
1	كائن	إتاحة طيف ألوان نموذج أحمر أخضر أزرق.
spectrumRgb	عدد صحيح	يجب ملء هذا الحقل. قيمة نموذج أحمر أخضر أزرق الطيف كعدد صحيح عشري.
2	كائن	إتاحة طيف طيف HSV للألوان.
spectrumHsv	كائن	يجب ملء هذا الحقل. قيمة Spectrum HSV
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	عدد صحيح	يجب ملء هذا الحقل. قيمة درجة الحرارة بالكلفن. يمكنك الاطّلاع على نموذج أحمر أخضر أزرق ونموذج أحمر أخضر أزرق ودرجة حرارة الألوان للحصول على مزيد من التفاصيل.
1	كائن	إتاحة طيف ألوان نموذج أحمر أخضر أزرق.
spectrumRGB	عدد صحيح	يجب ملء هذا الحقل. قيمة نموذج أحمر أخضر أزرق الطيف كعدد صحيح عشري. يمكنك الاطّلاع على نموذج أحمر أخضر أزرق ونموذج أحمر أخضر أزرق ودرجة حرارة الألوان للحصول على مزيد من التفاصيل.
2	كائن	إتاحة طيف طيف HSV للألوان.
spectrumHSV	كائن	يجب ملء هذا الحقل. قيمة Spectrum 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 المتوقّفة نهائيًا.

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

أخطاء الجهاز

راجِع القائمة الكاملة للأخطاء والاستثناءات.