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

مخطّط سمات إعداد الألوان في المنزل الذكي

action.devices.traits.ColorSetting - تنطبق هذه السمة على الأجهزة، مثل المصابيح الذكية، التي يمكن أن تغيّر اللون أو درجة حرارة الألوان.

RGB وHSV ودرجة حرارة الألوان

وتمثل ألوان نموذج أحمر أخضر أزرق ألوانًا ثلاثية (أحمر وأخضر وأزرق). إنّ نموذج أحمر أخضر أزرق هو نموذج الألوان التلقائي. ويمكن تمثيل أي حزمة ثلاثية الأبعاد بنموذج أحمر أخضر أزرق كرمز سداسي عشري، وهو ما يعادل القيم السداسية العشرية للتسلسل الثلاثي. على سبيل المثال، "أزرق" هو (0، 0، 255) و #0000FF. يمكنك استخدام أي قيمة ضمن مساحة اللون الأحمر والأخضر والأزرق، أي RGB(x, y, z) حيث x، y، z ضمن النطاق [0، 255]، بما في ذلك القيم الواقعة بينهما.

يمثل HSV الألوان كثلاثة ألوان (درجة تدرج، تشبع، قيمة). ويمكن تحويل أي قيمة لونية في HSV إلى نموذج أحمر أخضر أزرق، والعكس صحيح. يبلغ نطاق Hue [0, 360) درجة (باستثناء 360 درجة، بما أنها تلتف حول 0 درجة تقريبًا). يتم تمثيل تشبُّع القيمة والقيمة بـ عوامات في النطاق [0.0، 1.0].

تمثّل درجة حرارة الألوان بعض الألوان كقيم عشرية غير سالبة بالكلفن. تصف هذه السمة المصابيح "البيضاء" أو "الدافئة"، مع استخدام أسماء ألوان مثل "أبيض بارد" أو "ضوء الشمس ملبّد بالغيوم". عادةً ما يكون للمصابيح الذكية التي تدعم درجة حرارة الألوان نطاق [2000, 9000] كلفن، وهو ما يتوافق مع المصابيح التقليدية التي تستخدم درجة حرارة ثابتة بالكلفن. درجة حرارة الألوان عبارة عن مقياس خطي ومجموعة فرعية من نماذج ألوان RGB/HSV الكاملة الطيف. يمكنك الاطّلاع على الجدول أدناه لمعرفة بعض أمثلة درجات الحرارة وأسماء الألوان المقابلة.

درجة الحرارة (كلفن) اسم اللون
2,000ضوء الشموع
2500أبيض دافئ للغاية
3,000أبيض ناعم، أبيض صباحي، أبيض للقراءة
4,000أبيض بارد
5,000ضوء النهار، أبيض
6000أبيض زهري
7000غائم وضوء نهاري ودخان أبيض
8000طقس غائم أزرق
9000سماء زرقاء

الجهاز ATTRIBUTES

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

السمات النوع الوصف
commandOnlyColorSetting منطقي

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

تشير إلى ما إذا كان الجهاز يتيح استخدام اتصال أحادي الاتجاه (صحيح) أو ثنائي الاتجاه (خطأ). اضبط هذه السمة على "صحيح" إذا تعذّر على الجهاز الرد على طلب QUERY أو حالة التقرير لهذه السمة.

يحتوي على أي من العناصر التالية:
0 العنصر

دعم نموذج الألوان.

colorModel سلسلة

مطلوبة.

نموذج ألوان طيف كامل متوافق مع الجهاز.

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

rgb
hsv
1 العنصر

دعم درجة حرارة الألوان.

colorTemperatureRange العنصر

مطلوبة.

نطاق درجة حرارة اللون المتوافق بالكلفن.

temperatureMinK عدد صحيح

مطلوبة.

الحد الأدنى المعتمد لدرجة حرارة الألوان بالكلفن.

temperatureMaxK عدد صحيح

مطلوبة.

الحد الأقصى لدرجة حرارة اللون المسموح بها بالكلفن.

أمثلة

الجهاز الذي يتوافق مع كل من نموذج ألوان الطيف RGB ودرجة حرارة الألوان.

{
  "colorModel": "rgb",
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

الجهاز الذي لا يتوافق إلا مع نموذج ألوان طيف HSV

{
  "colorModel": "hsv"
}

الجهاز الذي يتيح درجة حرارة الألوان فقط.

{
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

الجهاز الذي يتوافق فقط مع أوامر نماذج ألوان HSV.

{
  "colorModel": "hsv",
  "commandOnlyColorSetting": true
}

حالة الجهاز STATES

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

الولايات النوع الوصف
color العنصر

مطلوبة.

إعداد اللون الحالي المُستخدَم حاليًا على الجهاز.

يحتوي على أحد العناصر التالية:
0 العنصر

دعم درجة حرارة الألوان.

temperatureK عدد صحيح

مطلوبة.

قيمة درجة الحرارة بالكلفن.

1 العنصر

دعم طيف ألوان نموذج أحمر أخضر أزرق.

spectrumRgb عدد صحيح

مطلوبة.

قيمة RGB لـ Spectrum كعدد صحيح عشري.

2 العنصر

دعم ألوان طيف HSV.

spectrumHsv العنصر

مطلوبة.

قيمة HSV لـ Spectrum.

hue Number

Hue.

saturation Number

تشبُّع اللون

value Number

القيمة.

أمثلة

ما هو لون الإضاءة؟ (أبيض دافئ)

{
  "color": {
    "temperatureK": 3000
  }
}

ما هو لون الإضاءة؟ (أحمر أرجواني)

{
  "color": {
    "spectrumRgb": 16711935
  }
}

ما هو لون الإضاءة؟ (أحمر أرجواني)

{
  "color": {
    "spectrumHsv": {
      "hue": 300,
      "saturation": 1,
      "value": 1
    }
  }
}

مفاتيح COMMAND

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

action.devices.commands.ColorAbsolute

تعيين قيمة اللون المطلقة.

المَعلمات

المَعلمات النوع الوصف
color العنصر

مطلوبة.

اللون المطلوب ضبطه.

name سلسلة

تم تحليل اسم اللون من أمر المستخدم، وقد لا يكون متاحًا دائمًا (أي عند استخدام أوامر نسبية).

يحتوي على أحد العناصر التالية:
0 العنصر

دعم درجة حرارة الألوان.

temperature عدد صحيح

مطلوبة.

قيمة درجة الحرارة بالكلفن.

1 العنصر

دعم طيف ألوان نموذج أحمر أخضر أزرق.

spectrumRGB عدد صحيح

مطلوبة.

قيمة RGB لـ Spectrum كعدد صحيح عشري.

2 العنصر

دعم ألوان طيف HSV.

spectrumHSV العنصر

مطلوبة.

قيمة HSV لـ Spectrum.

hue Number

Hue.

saturation Number

تشبُّع اللون

value Number

القيمة.

أمثلة

اجعل الضوء دافئًا أبيض اللون.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "warm white",
      "temperature": 3000
    }
  }
}

اصنعي اللون الأرجواني الفاتح.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "magenta",
      "spectrumRGB": 16711935
    }
  }
}

اصنعي اللون الأرجواني الفاتح.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "magenta",
      "spectrumHSV": {
        "hue": 300,
        "saturation": 1,
        "value": 1
      }
    }
  }
}

لاحظ أن أسماء المعلمات تختلف قليلاً بين معلمات الأوامر والحالة. ويؤدي ذلك إلى تجنّب التعارضات مع معلّمات الحالة للسمتَين ColorSpectrum وColorTemperature المتوقّف.

Command الولاية
temperature temperatureK
spectrumRGB spectrumRgb
spectrumHSV spectrumHsv

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

de-DE

  • Stell die Farbe der Lampe auf blau
  • Stelle die Farbtemperatur auf 3000 Kelvin ein.

en-US

  • can you adjust my lights color to 4000 kelvins
  • set the lights to blue

es-ES

  • pon azul la luz de la cocina
  • pon la luz a 2000 k de temperatura de color

fr-FR

  • Allume la lampe de la chambre à 3500 kelvins .
  • mets les lampes en rose dans la chambre

hi-IN

  • तुम लाइट को ब्लू कर दो
  • लैम्प 2000 केल्विन पर लगाओ।

it-IT

  • Imposta la lampada a 2000 K .
  • metti la luce gialla

ja-JP

  • 照明 の色を にして
  • 照明 の色温度を 5000K にセットして

ko-KR

  • 조명 색깔 흰색 으로 바꿔 줘
  • 주방 전등 색 온도를 5000 켈빈 으로 설정해

nl-NL

  • Zet de keukenlamp op 2000 Kelvin .
  • maak het licht rood

pt-BR

  • Colocar a lâmpada em 2000 K .
  • Define a lâmpada para 2000 K .
  • colocar a luz da sala em azul
  • põe a luz da sala a vermelho

sv-SE

  • Ställ in lampan 2000 Kelvin
  • tänd blått ljus i köket

أخطاء الجهاز

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