أمر نسبي

الوصف

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

الحقول

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

أجهزة مثل المصابيح التي تتيح تغيير مستوى السطوع

مطلوبة

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

النسبة المئوية الدقيقة للسطوع المطلوب تغييرها.

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

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

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

يشير هذا إلى المقدار الغامض لتغيير السطوع. ومن كمية صغيرة إلى كبيرة، سيتمّ تغيير حجم هذه المَعلمة إلى عدد صحيح من 0 إلى 5، مع الإشارة إلى الاتجاه.

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

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

أمثلة

actions:
  type: device.command.BrightnessRelative
  devices: My Device - Room Name
  brightnessRelativePercent: 50