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

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

النموذج اللوني أحمر أخضر أزرق (RGB) والنموذج اللوني هوى تشبّع قيمة (HSV) ودرجة حرارة الألوان

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

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

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

سمات الجهاز

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

أمثلة

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

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

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

{
  "colorModel": "hsv"
}

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

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

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

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

حالات الجهاز

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

أمثلة

ما هو لون الضوء؟ (أبيض ضارب للأصفر)

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

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

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

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

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

أوامر الجهاز

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

action.devices.commands.ColorAbsolute

تضبط هذه السمة قيمة اللون المطلقة.

المعلمات

أمثلة

ضبط لون المصابيح على الأبيض الدافئ

{
  "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.

عبارات نموذجية

أخطاء الجهاز