スマートホーム ColorSetting トレイトのスキーマ

action.devices.traits.ColorSetting - このトレイトは、色や色温度を変更できるスマートライトなどのデバイスに適用されます。

RGB、HSV、色温度

RGB は、色を（赤、緑、青）からなる 3 つの値の組で表します。RGB がデフォルトのカラーモデルです。RGB は、3 つの 16 進値を連結した 16 進コードで表せます。たとえば、「青」は (0, 0, 255) と #0000FF のどちらでも表せます。 RGB 色空間内の任意の値を使用できます。つまり、x、y、z が 0 以上、255 以下の RGB(x, y, z) です。

HSV は、色を（色相、彩度、明度）の 3 つの値の組で表します。HSV のどの色の値も RGB に変換でき、その逆も可能です。色相は、0 度以上、360 度未満の値で表されます（折り返して 0 度になるため、360 度は入りません）。彩度と明度は、0.0 以上、1.0 以下の 浮動小数点数で表されます。

色温度 は、一部の色をケルビン絶対温度の非負の 10 進数で表します。 この属性は、「白い」光や「暖かい」光を、「cool white」 や「overcast daylight」などの色の名前で表します。色温度をサポートするスマートライトは、通常 2, 000 以上、9, 000 以下のケルビン絶対温度をサポートします。これは、固定ケルビン絶対温度の従来のライトに対応します。色 温度は線形スケールであり、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 トレイトのステータス パラメータとの競合を回避できます。

サンプル音声

デバイスエラー