مخطط سمة LightEffects للمنزل المزوّد بأجهزة ذكية

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

سمات الجهاز

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

السمات النوع الوصف
defaultColorLoopDuration عدد صحيح

(القيمة التلقائية: 1800)

تمثّل هذه السمة المدة التلقائية بالثواني للتأثير الذي يبدأه الأمر action.devices.commands.ColorLoop.
defaultSleepDuration عدد صحيح

(القيمة التلقائية: 1800)

تمثّل هذه السمة المدة التلقائية بالثواني للتأثير الذي يبدأه الأمر action.devices.commands.Sleep.
defaultWakeDuration عدد صحيح

(القيمة التلقائية: 1800)

تمثّل هذه السمة المدة التلقائية بالثواني للتأثير الذي يبدأه الأمر action.devices.commands.Wake.
supportedEffects صفيف

يجب ملء هذا الحقل.

قائمة بالتأثيرات المتوافقة مع الجهاز
[item, ...] String

التأثير المسموح به

القيم المسموح بها:

colorLoop
تغيّر الألوان بشكل عشوائي.
sleep
يؤدي هذا الخيار إلى تقليل مستوى السطوع تدريجيًا وضبط درجة حرارة الألوان اختياريًا على مدار فترة زمنية معيّنة.
wake
تعمل هذه الميزة على زيادة درجة السطوع تدريجيًا، ويمكنك ضبط درجة حرارة الألوان تدريجيًا لفترة زمنية معيّنة.

أمثلة

الجهاز متوافق مع تأثير حلقة الألوان:

{
  "supportedEffects": [
    "colorLoop"
  ]
}

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

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

حالات الجهاز

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

الولايات النوع الوصف
activeLightEffect String

التأثير الضوئي النشط حاليًا في حال توفّره. الخيار واحد من بين supportedEffects

القيم المسموح بها:

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec عدد صحيح

الطابع الزمني لنظام التشغيل Unix الذي من المتوقّع أن ينتهي فيه التأثير تلقائيًا

أمثلة

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

{
  "activeLightEffect": "colorLoop"
}

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

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

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

{}

مفاتيح الجهاز

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

action.devices.commands.ColorLoop

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

يتطلب هذا الأمر السمات التالية: 
{
  "supportedEffects": [
    "colorLoop"
  ]
}

المَعلمات

المَعلمات النوع الوصف
duration عدد صحيح

المدة الخاصة بأمر إعادة التوجيه اللوني بالثواني.

أمثلة

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

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

action.devices.commands.Sleep

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

يتطلب هذا الأمر السمات التالية: 
{
  "supportedEffects": [
    "sleep"
  ]
}

المَعلمات

المَعلمات النوع الوصف
duration عدد صحيح

مدة أمر وضع السكون، بالثواني

أمثلة

ضبط مصابيحي على وضع السكون لمدة 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"
  ]
}

المَعلمات

المَعلمات النوع الوصف
duration عدد صحيح

مدة أمر التنشيط، بالثواني

أمثلة

تنشيط مصابيحي لمدة 60 دقيقة

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

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

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

نماذج من الأحاديث

de-DE

  • Den Aufwacheffekt der Lampen starten.
  • Einschlafmodus im Schlafzimmer aktivieren.
  • synchronisiere meine Geräte

en-US

  • Begin the sleep effect on my lights .
  • I want you to start wake effect on the lights

es-ES

  • pon la luz de despertarse lentamente durante 45 minutos
  • pon las luces de dormir

fr-FR

  • Allume doucement les lumières .
  • Éteins progressivement les lumières .

hi-IN

  • बेडरूम में धीरे-धीरे रोशनी बढ़ाओ
  • लाइट को स्लीप मोड में डाल दो

it-IT

  • Accendi le luci gradualmente
  • Avvia le luci per dormire

ja-JP

  • ライト を徐々に明るくなる設定にして
  • 照明 を少しずつ暗くして

ko-KR

  • 안방 전등 기상 모드 시작해
  • 조명 에서 수면 모드 실행

nl-NL

  • Dim de lichten langzaam.
  • Laat mijn lamp langzaam feller worden.

pt-BR

  • Acenda lentamente as luzes do quarto por 1 hora .
  • Ativa as luzes de despertar no quarto dos miudos .
  • Iniciar o modo dormir por 1 hora nas luzes do quarto .
  • Liga a função adormecer das luzes .

sv-SE

  • Starta insomningsläge på lamporna
  • Tänd lamporna långsamt

أخطاء الجهاز

راجِع القائمة الكاملة للأخطاء والاستثناءات.