طلب مطلق

الوصف

يتيح ضبط اللون على درجة اللون المحدّدة. عند ضبط اللون على جهاز غير مفعَّل، يتم تشغيل الجهاز ويتغيّر رمز OnOffState.state ليعكس ذلك. وبالمثل، عند ضبط السطوع على 0، يتم إيقاف تشغيل الجهاز ويتغيّر OnOffState.state وفقًا لذلك.

الحقول

المفتاح النوع الوصف
devices [Device]

الأجهزة التي يمكنها تغيير اللون أو درجة حرارة اللون، مثل المصابيح الذكية

مطلوب

color Color

اللون المطلوب ضبطه

مطلوب

name String

اسم اللون الذي تم تحليله من أمر المستخدم، وقد لا يكون متاحًا دائمًا (أي عند استخدام الأوامر النسبية).

اختياري

لاستخدام هذا الحقل، يجب عدم استخدام جميع الحقول التالية: temperature وspectrumRGB وspectrumHSV.

temperature ColorTemperature

قيمة درجة الحرارة بالكلفن.

اختياري

لاستخدام هذا الحقل، يجب عدم استخدام جميع الحقول التالية: name وspectrumRGB وspectrumHSV.

يعتمد نطاق الأرقام القيم على كل جهاز.

spectrumRGB ColorHex

قيمة النموذج اللوني (RGB) الطيفي كعدد صحيح عشري.

اختياري

لاستخدام هذا الحقل، يجب عدم استخدام جميع الحقول التالية: name وtemperature وspectrumHSV

قد لا تتوافق بعض الأجهزة مع هذا الحقل.

spectrumHSV SpectrumHSV

قيمة النموذج اللوني (HSV) الطيفي

اختياري

لاستخدام هذا الحقل، يجب عدم استخدام جميع الحقول التالية: temperature وspectrumRGB وname

قد لا تتوافق بعض الأجهزة مع هذا الحقل.

hue Number

تدرّج اللون

مطلوب

saturation Number

تشبُّع اللون

مطلوب

value Number

القيمة

مطلوب

أمثلة

actions:
- type: device.command.ColorAbsolute
  devices: My Device - Room Name
  color:
    name: blue