مرحبًا بك في "مركز مطوّري برامج Google Home"، وجهتك الجديدة لتعلّم كيفية تطوير إجراءات منزلية ذكية. ملاحظة: ستواصل إنشاء الإجراءات في وحدة تحكم الإجراءات.
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

مخطّط سمات LightHomes لتطبيق Smart Home

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

الجهاز ATTRIBUTES

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

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

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

المدة التلقائية بالثواني للتأثير الذي تم تشغيله بواسطة الأمر action.devices.commands.ColorLoop.

defaultSleepDuration عدد صحيح

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

المدة التلقائية بالثواني للتأثير الذي تم تشغيله بواسطة الأمر action.devices.commands.Sleep.

defaultWakeDuration عدد صحيح

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

المدة التلقائية بالثواني للتأثير الذي تم تشغيله بواسطة الأمر action.devices.commands.Wake.

supportedEffects المصفوفة

مطلوبة.

قائمة التأثيرات التي يسمح بها الجهاز.

[item, ...] سلسلة

التأثير المعتمد.

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

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

أمثلة

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

{
  "supportedEffects": [
    "colorLoop"
  ]
}

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

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

حالة الجهاز STATES

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

الولايات النوع الوصف
activeLightEffect سلسلة

تأثير الضوء النشط حاليًا، إن وجد. أحد supportedEffects.

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

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec عدد صحيح

الطابع الزمني لنظام التشغيل Unix الذي يُتوقع أن ينتهي التأثير فيه، إذا كان التأثير ينتهي من تلقاء نفسه.

أمثلة

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

{
  "activeLightEffect": "colorLoop"
}

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

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

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

{}

مفاتيح COMMAND

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

نماذج من الألفاظ

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

أخطاء الجهاز

يمكنك الاطلاع على القائمة الكاملة للأخطاء والاستثناءات.