طلب مطلق

الوصف

يتيح ضبط اللون على درجة اللون المحدّدة. عند ضبط اللون على جهاز غير مفعَّل، يتم تشغيل الجهاز ويتغيّر رمز 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