مخطط سمة 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.

نماذج عبارات

أخطاء الجهاز