طلب مطلق

الوصف

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

الحقول

المفتاح Type الوصف
devices [الجهاز]

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

مطلوبة

المتغير مسموح به.

color اللون

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

مطلوبة

name String

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

إجراء اختياري

لاستخدام هذا الحقل، لا يمكن استخدام كل الحقول التالية: temperature وspectrumRGB وspectrumHSV

المتغير مسموح به.

temperature ColorTemperature

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

إجراء اختياري

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

المتغير مسموح به.

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

spectrumRGB ColorHex

قيمة Spectrum RGB كعدد صحيح عشري.

إجراء اختياري

لاستخدام هذا الحقل، لا يمكن استخدام كل الحقول التالية: name وtemperature وspectrumHSV

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

المتغير مسموح به.

spectrumHSV SpectrumHSV

قيمة HSV في Spectrum HSV

إجراء اختياري

لاستخدام هذا الحقل، لا يمكن استخدام كل الحقول التالية: temperature، spectrumRGB، الاسم

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

hue Number

تدرُّج اللون.

مطلوبة

المتغير مسموح به.

saturation Number

تشبُّع اللون

مطلوبة

المتغير مسموح به.

value Number

القيمة.

مطلوبة

المتغير مسموح به.

أمثلة

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