طرحواره صفت تنظیم رنگ خانه هوشمند

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 بولی

(پیش‌فرض: false )

نشان می دهد که آیا دستگاه از ارتباط یک طرفه (درست) یا دو طرفه (کاذب) پشتیبانی می کند. اگر دستگاه نمی تواند به یک هدف QUERY یا وضعیت گزارش برای این ویژگی پاسخ دهد، این ویژگی را روی true تنظیم کنید.

حاوی هر یک از موارد زیر است:
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
}

وضعیت دستگاه

موجودیت های دارای این ویژگی ممکن است وضعیت های زیر را به عنوان بخشی از عملیات 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 lampan 2000 Kelvin
  • tänd blått ljus i köket

خطاهای دستگاه

لیست کامل خطاها و استثناها را ببینید.