مخطّط سمة تأثيرات الإضاءة في المنزل الذكي

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

سمات الجهاز

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

أمثلة

جهاز يتيح تأثير حلقة الألوان

{
  "supportedEffects": [
    "colorLoop"
  ]
}

الجهاز يتوافق مع تأثيرات النوم/التنشيط.

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

حالة الجهاز

يمكن للجهات التي تستخدم هذه السمة الإبلاغ عن الحالات التالية كجزء من عملية QUERY. لمزيد من المعلومات حول كيفية التعامل مع نية QUERY، يمكنك الاطّلاع على التنفيذ حسب نية العميل.

أمثلة

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

{
  "activeLightEffect": "colorLoop"
}

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

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

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

{}

CommandS للجهاز

قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر التالية كجزء من عملية 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، ستتوافق المنصة مع تأثيرات "النوم" و"الاستيقاظ" التي تتم محاكاتها، بدون الحاجة إلى رمز إضافي. تحاكي المنصة التأثيرات من خلال إرسال سلسلة من نوايا التنفيذ.

نماذج الطلبات

أخطاء الجهاز