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

‫action.devices.traits.LightEffects: تنتمي هذه السمة إلى الأجهزة التي يمكنها تنفيذ أوامر إضاءة معقّدة لتغيير الحالة، مثل التكرار الحلقي بين ألوان مختلفة.

سمات الجهاز

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

أمثلة

جهاز يتيح استخدام تأثير الألوان المتكررة

{
  "supportedEffects": [
    "colorLoop"
  ]
}

جهاز متوافق مع تأثيرات النوم/الاستيقاظ

{
  "defaultSleepDuration": 300,
  "defaultWakeDuration": 600,
  "supportedEffects": [
    "sleep",
    "wake"
  ]
}

حالات الجهاز

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

أمثلة

ما هو التأثير الحالي على جهازي؟

{
  "activeLightEffect": "colorLoop"
}

ما هو التأثير الحالي على جهازي؟

{
  "activeLightEffect": "sleep",
  "lightEffectEndUnixTimestampSec": 1595286869
}

لا يتوفّر حاليًا أي تأثير ضوئي نشط.

{}

أوامر الجهاز

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

action.devices.commands.ColorLoop

اطلب من الجهاز التنقّل بين مجموعة من الألوان.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

المعلمات

أمثلة

أريد أن تتغير ألوان الأضواء كل 60 دقيقة.

{
  "command": "action.devices.commands.ColorLoop",
  "params": {
    "duration": 3600
  }
}

action.devices.commands.Sleep

يتم خفض مستوى سطوع الجهاز تدريجيًا، ويمكنك أيضًا ضبط درجة حرارة الألوان على مدار فترة زمنية.

{
  "supportedEffects": [
    "sleep"
  ]
}

المعلمات

أمثلة

أريد أن تومض مصابيحي لمدة 60 دقيقة.

{
  "command": "action.devices.commands.Sleep",
  "params": {
    "duration": 3600
  }
}

action.devices.commands.StopEffect

إيقاف المؤثّر الضوئي الحالي

المعلمات

أمثلة

إيقاف المؤثر على الإضاءة

{
  "command": "action.devices.commands.StopEffect",
  "params": {}
}

action.devices.commands.Wake

زيادة مستوى سطوع الجهاز تدريجيًا، وتعديل درجة حرارة الألوان اختياريًا على مدار فترة زمنية

{
  "supportedEffects": [
    "wake"
  ]
}

المعلمات

أمثلة

اجعل مصابيحي تستيقظ لمدة 60 دقيقة.

{
  "command": "action.devices.commands.Wake",
  "params": {
    "duration": 3600
  }
}

محاكاة المؤثرات الضوئية

إذا كان جهازك ينفّذ السمة Brightness ولكن ليس السمة LightEffects، تتيح المنصة محاكاة تأثيرَي "السكون" و "الاستيقاظ" بدون الحاجة إلى رمز إضافي. يحاكي النظام الأساسي التأثيرات من خلال إرسال سلسلة من طلبات EXECUTE.

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

أخطاء الجهاز