مخطّط سمة ColorSetting في المنزل الذكي

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

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

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

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

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

درجة الحرارة (كلفن)	اسم اللون
2000	مصباح على شكل شمعة
2500	أبيض دافئ للغاية
3000	أبيض فاتح، أبيض صباحي، أبيض للقراءة
4000	أبيض بارد
5000	ضوء النهار، أبيض
6000	أبيض زهري
7000	ضوء نهاري غائم، دخان أبيض
8000	أزرق غائم
9000	أزرق سماوي

سمات الجهاز

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

السمات	النوع	الوصف
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، يمكنك الاطّلاع على التنفيذ حسب نية العميل.

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

اضبط القيمة المطلقة للّون.

المعلمات

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

أخطاء الجهاز

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