طرحواره صفت تنظیم رنگ خانه هوشمند
action.devices.traits.ColorSetting
- این ویژگی برای دستگاه هایی مانند چراغ های هوشمند که می توانند رنگ یا دمای رنگ را تغییر دهند اعمال می شود.
RGB، HSV، و دمای رنگ
RGB رنگ ها را به صورت سه گانه (قرمز، سبز، آبی) نشان می دهد. RGB مدل رنگی پیش فرض است. هر سه گانه RGB ممکن است به عنوان یک کد هگزا، معادل مقادیر هگزادسیمال برای سه گانه الحاق شده نشان داده شود. به عنوان مثال، "آبی" (0، 0، 255) و #0000FF است. می توانید از هر مقداری در فضای رنگی RGB استفاده کنید. یعنی RGB(x، y، z) که در آن x، y، z در محدوده [0، 255]، شامل میشوند.
HSV رنگ ها را به صورت سه گانه (رنگ، اشباع، ارزش) نشان می دهد. هر مقدار رنگ در HSV ممکن است به RGB تبدیل شود و بالعکس. Hue دارای محدوده [0، 360) درجه است (به استثنای 360، زیرا تا 0 درجه پیچیده می شود). اشباع و مقدار با شناورهایی در محدوده [0.0، 1.0] نشان داده می شود.
دمای رنگ برخی از رنگ ها را به صورت مقادیر اعشاری غیر منفی در کلوین نشان می دهد. این ویژگی نورهای «سفید» یا «گرما» را با نامهای رنگی مانند «سفید خنک» یا «نور روز ابری» توصیف میکند. چراغهای هوشمندی که دمای رنگ را پشتیبانی میکنند، معمولاً محدوده کلوین [2000، 9000] دارند، که مربوط به چراغهای معمولی با کلوین ثابت است. دمای رنگ یک مقیاس خطی و زیرمجموعه ای از مدل های رنگی طیف کامل RGB/HSV است. برای نمونههایی از دماها و نامهای رنگ مربوطه، جدول زیر را ببینید.
دما (کلوین) | نام رنگ |
---|---|
2000 | نور شمع |
2500 | سفید فوق العاده گرم |
3000 | سفید ملایم، سفید صبحگاهی، سفید خواندن |
4000 | سفید سرد |
5000 | نور روز، سفید |
6000 | سفید گلدار |
7000 | نور روز ابری، دود سفید |
8000 | آبی ابری |
9000 | آسمان آبی |
ویژگی های دستگاه
دستگاه های دارای این ویژگی ممکن است ویژگی های زیر را به عنوان بخشی از عملیات SYNC
گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد SYNC
، به تحقق هدف مراجعه کنید.
ویژگی های | تایپ کنید | شرح |
---|---|---|
commandOnlyColorSetting | بولی | (پیشفرض: نشان می دهد که آیا دستگاه از ارتباط یک طرفه (درست) یا دو طرفه (کاذب) پشتیبانی می کند. اگر دستگاه نمی تواند به یک هدف QUERY یا وضعیت گزارش برای این ویژگی پاسخ دهد، این ویژگی را روی true تنظیم کنید. |
حاوی هر یک از موارد زیر است: | ||
0 | هدف - شی | پشتیبانی از مدل رنگ |
colorModel | رشته | ضروری. مدل رنگ طیف کامل که توسط دستگاه پشتیبانی می شود. مقادیر پشتیبانی شده:
|
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 }
وضعیت دستگاه
موجودیت های دارای این ویژگی ممکن است وضعیت های زیر را به عنوان بخشی از عملیات QUERY
گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد QUERY
، به تحقق هدف مراجعه کنید.
ایالت ها | تایپ کنید | شرح |
---|---|---|
color | هدف - شی | ضروری. تنظیم رنگ فعلی که در حال حاضر در دستگاه استفاده می شود. |
حاوی یکی از موارد زیر است: | ||
0 | هدف - شی | پشتیبانی از دمای رنگ |
temperatureK | عدد صحیح | ضروری. مقدار دما بر حسب کلوین |
1 | هدف - شی | پشتیبانی از طیف رنگی RGB |
spectrumRgb | عدد صحیح | ضروری. مقدار RGB طیف به عنوان یک عدد صحیح اعشاری. |
2 | هدف - شی | پشتیبانی از طیف رنگی HSV |
spectrumHsv | هدف - شی | ضروری. مقدار HSV طیف |
hue | عدد | رنگ. |
saturation | عدد | اشباع. |
value | عدد | ارزش. |
مثال ها
رنگ نور چیست؟ (سفید گرم)
{ "color": { "temperatureK": 3000 } }
رنگ نور چیست؟ (ارغوانی)
{ "color": { "spectrumRgb": 16711935 } }
رنگ نور چیست؟ (ارغوانی)
{ "color": { "spectrumHsv": { "hue": 300, "saturation": 1, "value": 1 } } }
دستورات دستگاه
دستگاه های دارای این ویژگی ممکن است به دستورات زیر به عنوان بخشی از عملیات EXECUTE
پاسخ دهند. برای کسب اطلاعات بیشتر در مورد مدیریت EXECUTE
intent ها، به اجرای Intent مراجعه کنید.
action.devices.commands.ColorAbsolute
مقدار مطلق رنگ را تنظیم کنید.
مولفه های
مولفه های | تایپ کنید | شرح |
---|---|---|
color | هدف - شی | ضروری. رنگ برای تنظیم. |
name | رشته | نام رنگ از دستور کاربر تجزیه شده است. ممکن است همیشه در دسترس نباشد (یعنی هنگام استفاده از دستورات نسبی). |
حاوی یکی از موارد زیر است: | ||
0 | هدف - شی | پشتیبانی از دمای رنگ |
temperature | عدد صحیح | ضروری. مقدار دما بر حسب کلوین برای جزئیات ، RGB، HSV، و دمای رنگ را ببینید. |
1 | هدف - شی | پشتیبانی از طیف رنگی RGB |
spectrumRGB | عدد صحیح | ضروری. مقدار RGB طیف به عنوان یک عدد صحیح اعشاری. برای جزئیات ، RGB، HSV، و دمای رنگ را ببینید. |
2 | هدف - شی | پشتیبانی از طیف رنگی HSV |
spectrumHSV | هدف - شی | ضروری. مقدار HSV طیف برای جزئیات ، RGB، HSV، و دمای رنگ را ببینید. |
hue | عدد | رنگ. |
saturation | عدد | اشباع. |
value | عدد | ارزش. |
مثال ها
نور را سفید گرم کنید.
{ "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 منسوخ جلوگیری می کند.
فرمان | حالت |
---|---|
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 تنظیم کنید
- the lights to blue set
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
سلام ورود
- तुम लाइट को ब्लू कर दो
- लैम्प 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 .
- a lâmpada para 2000 K Define .
- colocar a luz da sala em azul
- põe a luz da sala a vermelho
sv-SE
- Ställ in på lampan 2000 Kelvin
- tänd blått ljus i köket