Добро пожаловать в Центр разработчиков Google Home, новое место, где можно научиться разрабатывать действия для умного дома. Примечание. Вы продолжите создавать действия в консоли действий.
Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Схема свойств умного дома ColorSetting

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. В таблице ниже приведены некоторые примеры температуры и соответствующие названия цветов.

Температура (Кельвин) Название цвета
2000 г. Свеча
2500 Ультра теплый белый
3000 Мягкий белый, утренний белый, белый для чтения
4000 Холодный белый
5000 Дневной свет, белый
6000 цветочный белый
7000 Облачный дневной свет, белый дым
8000 Синяя облачность
9000 Голубое небо

АТРИБУТЫ устройства

Устройства с этой чертой могут сообщать о следующих атрибутах как часть операции SYNC . Дополнительные сведения об обработке намерений SYNC см. в разделе Выполнение намерений .

Атрибуты Тип Описание
commandOnlyColorSetting логический

(По умолчанию: false )

Указывает, поддерживает ли устройство одностороннюю (правда) или двустороннюю (ложь) связь. Установите для этого атрибута значение true, если устройство не может ответить на намерение QUERY или отчет о состоянии для этой черты.

Содержит любой из следующих элементов:
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 см. в разделе Выполнение намерений .

action.devices.commands.ColorAbsolute

Установите абсолютное значение цвета.

Параметры

Параметры Тип Описание
color Объект

Необходимый.

Цвет для установки.

name Нить

Имя цвета, полученное из команды пользователя; не всегда могут быть доступны (например, при использовании относительных команд).

Содержит один из следующих элементов:
0 Объект

Поддержка цветовой температуры.

temperature Целое число

Необходимый.

Значение температуры в Кельвинах.

1 Объект

Поддержка цветового спектра RGB.

spectrumRGB Целое число

Необходимый.

Значение спектра RGB в виде десятичного целого числа.

2 Объект

Поддержка цветового спектра HSV.

spectrumHSV Объект

Необходимый.

Значение спектра 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

  • 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
  • set the lights to blue

эс-эс

  • pon azul la luz de la cocina
  • pon la luz a 2000 k de temperatura de color

а как

  • Allume la lampe de la chambre à 3500 kelvins .
  • mets les lampes en rose dans la chambre

привет-IN

  • तुम लाइट को ब्लू कर दो
  • लैम्प 2000 केल्विन पर लगाओ।

это-это

  • Imposta la lampada a 2000 K .
  • metti la luce gialla

ja-JP

  • 照明の色をにして
  • 照明の色温度を 5000Kにセットして

ко-КР

  • 조명 색깔 흰색 으로 바꿔 줘
  • 주방 전등 색 온도를 5000 켈빈 으로 설정해

нл-нл

  • Zet de keukenlamp op 2000 Kelvin .
  • maak het licht rood

пт-BR

  • Colocar a lâmpada em 2000 K .
  • Define a lâmpada para 2000 K .
  • colocar a luz da sala em azul
  • põe a luz da sala a vermelho

св-СЭ

  • Ställ in lampan 2000 Kelvin
  • tänd blått ljus i köket

ОШИБКИ устройства

См. полный список ошибок и исключений .