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

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

سمات الجهاز

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

أمثلة

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

{
  "supportedEffects": [
    "colorLoop"
  ]
}

جهاز متوافق مع تأثيرات وضعي السكون والتنشيط

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

حالات الجهاز

يمكن أن تُبلغ الكيانات التي تتضمّن هذه السمة عن الحالات التالية كجزء من عملية QUERY. للاطّلاع على مزيد من المعلومات عن معالجة QUERY intents، اطّلِع على تلبية النية.

أمثلة

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

{
  "activeLightEffect": "colorLoop"
}

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

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

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

{}

أوامر الجهاز

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

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

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

أخطاء الجهاز