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

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 است. برای نمونه‌هایی از دماها و نام‌های رنگ مربوطه، جدول زیر را ببینید.

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

دستگاه های دارای این ویژگی ممکن است ویژگی های زیر را به عنوان بخشی از عملیات 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 intent ها، به اجرای Intent مراجعه کنید.

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 منسوخ جلوگیری می کند.

نمونه گفته ها

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