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

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 تبدیل شود و برعکس. رنگ دارای محدوده [0، 360] درجه است (به جز 360، زیرا تا 0 درجه می‌پیچد). اشباع و مقدار توسط اعشار در محدوده [0.0، 1.0] نمایش داده می‌شوند.

دمای رنگ، برخی از رنگ‌ها را به صورت مقادیر اعشاری غیرمنفی بر حسب کلوین نشان می‌دهد. این ویژگی، نورهای "سفید" یا "گرم" را با نام‌های رنگی مانند "سفید سرد" یا "نور روز ابری" توصیف می‌کند. چراغ‌های هوشمندی که از دمای رنگ پشتیبانی می‌کنند، معمولاً دارای محدوده [2000، 9000] کلوین هستند که با چراغ‌های معمولی با کلوین ثابت مطابقت دارد. دمای رنگ یک مقیاس خطی و زیرمجموعه‌ای از مدل‌های رنگی طیف کامل RGB/HSV است. برای مشاهده برخی از دماهای نمونه و نام‌های رنگی مربوطه، به جدول زیر مراجعه کنید.

ویژگی‌های دستگاه

دستگاه‌هایی که این ویژگی را دارند، ممکن است ویژگی‌های زیر را به عنوان بخشی از عملیات SYNC گزارش دهند. برای کسب اطلاعات بیشتر در مورد مدیریت اهداف SYNC ، به بخش «تحقق اهداف» مراجعه کنید.

مثال‌ها

دستگاهی که هم از مدل رنگ طیف RGB و هم از دمای رنگ پشتیبانی می‌کند.

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

دستگاهی که فقط از مدل رنگ طیف HSV پشتیبانی می‌کند.

{
  "colorModel": "hsv"
}

دستگاهی که فقط از دمای رنگ پشتیبانی می‌کند.

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

دستگاهی که فقط از دستورات مدل رنگ HSV پشتیبانی می‌کند.

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

وضعیت دستگاه

موجودیت‌هایی با این ویژگی ممکن است حالت‌های زیر را به عنوان بخشی از عملیات QUERY گزارش دهند. برای کسب اطلاعات بیشتر در مورد مدیریت اهداف QUERY ، به بخش «تحقق اهداف» مراجعه کنید.

مثال‌ها

رنگ نور چیست؟ (سفید گرم)

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

رنگ نور چیست؟ (ارغوانی)

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

رنگ نور چیست؟ (ارغوانی)

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

دستورات دستگاه

دستگاه‌هایی که این ویژگی را دارند، می‌توانند به دستورات زیر به عنوان بخشی از عملیات EXECUTE پاسخ دهند. برای کسب اطلاعات بیشتر در مورد مدیریت اهداف EXECUTE ، به بخش «تحقق اهداف» مراجعه کنید.

action.devices.commands.ColorAbsolute

مقدار رنگ مطلق را تنظیم کنید.

پارامترها

مثال‌ها

نور را سفید گرم کنید.

{
  "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 جلوگیری می‌کند.

نمونه گفته‌ها

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