Philips HUE (независимый издатель)

Philips HUE позволяет управлять умными домашними устройствами, такими как свет, коммутаторы, подключаемые модули и более построенные Philips.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Tomasz Poszytek
URL https://aka.ms/poszytek
Адрес электронной почты tomasz@poszytek.eu
Метаданные соединителя
Publisher Tomasz Poszytek
Website https://www.philips-hue.com/
Политика конфиденциальности https://www.philips-hue.com/en-us/support/legal/privacy-policy
Категории Интернет вещей; Образ жизни и развлечения

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию Параметры для создания подключения. Все регионы Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя Тип Description Обязательно
Ключ приложения HUE securestring Ключ API, возвращаемый после выполнения вызовов авторизации PUT и POST. True

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Выполнение света

Выполнение устройства с возможностью молнии.

Выполнение устройства

Выполнение определенного устройства.

Получение номеров

Получение списка номеров (групп).

Получение света

Получение сведений о конкретном устройстве с возможностями молнии.

Получение света

Получите список устройств, имеющих возможности молнии.

Получение сцен

Получение списка всех сцен. Сцены используются для хранения и отзыва параметров для группы огней.

Получение сцены

Получение сведений о конкретной сцене.

Получение устройств

Получение списка всех устройств.

Получение устройства

Получение сведений о конкретном устройстве.

Удаление сцены

Удаление определенной сцены.

Выполнение света

Выполнение устройства с возможностью молнии.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор устройства
DeviceId True string

Идентификатор устройства для обновления свойств.

Имя
name string

MinLength: 1 - maxLength: 32. Доступное для чтения имя ресурса.

Включено
on boolean

Вкл./Выкл. Состояние освещения on=true, off=false.

Яркость
brightness float

Максимум: 100. Процент яркости. Запись 0 изменяет ее на наименьшую возможную яркость.

Мирек
mirek integer

Минимум: 153 – максимум: 500. Цветовая температура в мираке или null, если светлый цвет не находится в спектре ct.

X
x float

Минимум: 0 – максимум: 1. Положение X в цветовой гамме.

У
y float

Минимум: 0 – максимум: 1. Позиция Y в цветовой гамме.

Скорость
speed float

Минимум: 0 – максимум: 1. Скорость динамической палитры. Скорость допустима для динамической палитры, если состояние dynamic_palette или для соответствующего эффекта, указанного в состоянии. В случае состояния нет, скорость недействительна.

Продолжительность
duration integer

Максимум: 6000000. Длительность светлого перехода в мс. Точность выполняется в 100 мс.

Действие
action string

Одно из доступных действий для выполнения на устройстве. Т. е. "дышать".

X
x float

Минимум: 0 – максимум: 1. Положение X в цветовой гамме.

У
y float

Минимум: 0 – максимум: 1. Позиция Y в цветовой гамме.

Возвращаемое значение

Имя Путь Тип Описание
данные
data array of object

данные

избавлять
data.rid string

избавлять

rtype
data.rtype string

rtype

Ошибки
errors array of object

Ошибки, возникшие во время вызова.

Описание ошибки
errors.description string

Понятное для человека объяснение, конкретное для этого возникновения проблемы.

Выполнение устройства

Выполнение определенного устройства.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор устройства
DeviceId True string

Идентификатор устройства для обновления метаданных.

Прототип
archetype string

По умолчанию архетип, заданный производителем.

Имя
name string

Доступное для чтения имя ресурса (максимум 32 символов).

Действие
action string

Введите "идентификация", чтобы активировать идентификацию. Мост выполняет циклы идентификации светодиодных индикаторов Zigbee в течение 5 секунд. Свет выполняет один цикл дыхания. Датчики выполняют циклы идентификации светодиодных индикаторов в течение 15 секунд.

Возвращаемое значение

Имя Путь Тип Описание
данные
data array of object

Обновленные устройства.

избавлять
data.rid string

Уникальный идентификатор указанного ресурса.

rtype
data.rtype string

Тип указанного ресурса.

Ошибки
errors array of object

Ошибки, возникшие во время вызова.

Описание ошибки
errors.description string

Понятное для человека объяснение, конкретное для этого возникновения проблемы.

Получение номеров

Получение списка номеров (групп).

Возвращаемое значение

Имя Путь Тип Описание
Ошибки
errors array of object

Ошибки, возникшие во время вызова.

Описание ошибки
errors.description string

Понятное для человека объяснение, конкретное для этого возникновения проблемы.

данные
data array of object

Данные.

Дети
data.children array of object

Устройства для группировки по комнате. Разрешены следующие дочерние элементы: "устройство".

избавлять
data.children.rid string

Уникальный идентификатор созданной сцены.

rtype
data.children.rtype string

Тип созданной сцены.

Сгруппированные службы
data.grouped_services array of object

Ссылки на агрегированные службы управления. Не рекомендуется: использовать службы.

избавлять
data.grouped_services.rid string

Уникальный идентификатор созданной сцены.

rtype
data.grouped_services.rtype string

Тип созданной сцены.

Идентификатор
data.id string

Уникальный идентификатор, представляющий конкретный экземпляр ресурса.

Идентификатор версии 1
data.id_v1 string

Идентификатор ресурса клипа версии 1 (для использования в API версии 1).

Прототип
data.metadata.archetype string

Архетип по умолчанию, заданный производителем.

Имя
data.metadata.name string

Доступное для чтения имя ресурса.

Services
data.services array of object

Ссылается на все службы, агрегирующие управление и состояние дочерних элементов в группе. Агрегирование — это тип службы, т. е. каждый тип службы, который можно сгруппировать, имеет соответствующее определение сгруппированного типа. Поддерживаемые типы: "light".

избавлять
data.services.rid string

Уникальный идентификатор созданной сцены.

rtype
data.services.rtype string

Тип созданной сцены.

Тип
data.type string

Тип поддерживаемых ресурсов.

Получение света

Получение сведений о конкретном устройстве с возможностями молнии.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор устройства
DeviceId True string

Идентификатор устройства для отображения сведений.

Возвращаемое значение

Имя Путь Тип Описание
Ошибки
errors array of object

Ошибки, возникшие во время вызова.

Описание ошибки
errors.description string

Понятное для человека объяснение, конкретное для этого возникновения проблемы.

данные
data array of object

Свет, соответствующий заданному идентификатору.

Значения действия
data.alert.action_values array of string

Список эффектов генерации оповещений, поддерживаемых светом.

Синий X
data.color.gamut.blue.x float

Положение X в цветовой гамме.

Синий Y
data.color.gamut.blue.y float

Позиция Y в цветовой гамме.

Зеленый X
data.color.gamut.green.x float

Положение X в цветовой гамме.

Зеленый Y
data.color.gamut.green.y float

Положение X в цветовой гамме.

Красный X
data.color.gamut.red.x float

Положение X в цветовой гамме.

Красный Y
data.color.gamut.red.y float

Положение X в цветовой гамме.

Тип gamut
data.color.gamut_type string

Типы гаммы, поддерживаемые оттенками: A - Gamut ранних продуктов Philips только для цвета, B - Limited gamut первых цветов hue цветных продуктов, C - Richer color gamut hue white and color ambiance products, other - Color gamut не-hue продуктов.

X
data.color.xy.x float

Положение X в цветовой гамме.

У
data.color.xy.y float

Позиция Y в цветовой гамме.

Мирек
data.color_temperature.mirek integer

Цветовая температура в мираке или null, если светлый цвет не находится в спектре ct.

Максимальное значение Mirek
data.color_temperature.mirek_schema.mirek_maximum integer

Максимальная цветовая температура этого света поддерживается.

Минимальный мирек
data.color_temperature.mirek_schema.mirek_minimum integer

Минимальная температура цвета поддерживает этот свет.

Допустимый Мирек
data.color_temperature.mirek_valid boolean

Указывает, допустимо ли значение, представленное в mirek.

Яркость
data.dimming.brightness float

Процент яркости. Значение не может быть равно 0, запись 0 изменяет ее на наименьшую возможную яркость.

Минимальный уровень тусклых
data.dimming.min_dim_level float

Процент максимальной громкости устройства выводится на минимальную яркость.

Скорость
data.dynamics.speed float

Скорость динамической палитры или эффекта. Скорость допустима для динамической палитры, если состояние dynamic_palette или для соответствующего эффекта, указанного в состоянии. В случае состояния нет, скорость недействительна.

Допустимая скорость
data.dynamics.speed_valid boolean

Указывает, допустимо ли значение, представленное в скорости.

Состояние
data.dynamics.status string

Текущее состояние лампы с динамикой.

Значения состояния
data.dynamics.status_values array of string

Состояния, в которых лампа может быть при воспроизведении динамики.

Идентификатор ресурса
data.id string

Уникальный идентификатор, представляющий конкретный экземпляр ресурса.

Идентификатор ресурса "Клип версии 1"
data.id_v1 string

Идентификатор ресурса клипа версии 1 (версия API версии 1).

Прототип
data.metadata.archetype string

Свет архетипа. Не рекомендуется: используйте архетип на уровне устройства.

Указанное имя устройства
data.metadata.name string

Доступное для чтения имя ресурса.

Mode
data.mode string

Один из: обычный или потоковой передачи.

Состояние света
data.on.on boolean

Вкл./Выкл. Состояние света: on=true, off=false.

RID
data.owner.rid string

Уникальный идентификатор указанного ресурса.

Rtype
data.owner.rtype string

Тип указанного ресурса.

Тип
data.type string

Тип поддерживаемых ресурсов.

Получение света

Получите список устройств, имеющих возможности молнии.

Возвращаемое значение

Имя Путь Тип Описание
Ошибки
errors array of object

Ошибки, возникшие во время вызова.

Описание ошибки
errors.description string

Понятное для человека объяснение, конкретное для этого возникновения проблемы.

данные
data array of object

Пользователь огни.

Значения действия
data.alert.action_values array of string

Список эффектов генерации оповещений, поддерживаемых светом.

Синий X
data.color.gamut.blue.x float

Положение X в цветовой гамме.

Синий Y
data.color.gamut.blue.y float

Позиция Y в цветовой гамме.

Зеленый X
data.color.gamut.green.x float

Положение X в цветовой гамме.

Зеленый Y
data.color.gamut.green.y float

Положение X в цветовой гамме.

Красный X
data.color.gamut.red.x float

Положение X в цветовой гамме.

Красный Y
data.color.gamut.red.y float

Положение X в цветовой гамме.

Тип gamut
data.color.gamut_type string

Типы гаммы, поддерживаемые оттенками: A - Gamut ранних продуктов Philips только для цвета, B - Limited gamut первых цветов hue цветных продуктов, C - Richer color gamut hue white and color ambiance products, other - Color gamut не-hue продуктов.

X
data.color.xy.x float

Положение X в цветовой гамме.

У
data.color.xy.y float

Позиция Y в цветовой гамме.

Мирек
data.color_temperature.mirek integer

Цветовая температура в мираке или null, если светлый цвет не находится в спектре ct.

Максимальное значение Mirek
data.color_temperature.mirek_schema.mirek_maximum integer

Максимальная цветовая температура этого света поддерживается.

Минимальный мирек
data.color_temperature.mirek_schema.mirek_minimum integer

Минимальная температура цвета поддерживает этот свет.

Допустимый Мирек
data.color_temperature.mirek_valid boolean

Указывает, допустимо ли значение, представленное в mirek.

Яркость
data.dimming.brightness float

Процент яркости. Значение не может быть равно 0, запись 0 изменяет ее на наименьшую возможную яркость.

Минимальный уровень тусклых
data.dimming.min_dim_level float

Процент максимальной громкости устройства выводится на минимальную яркость.

Скорость
data.dynamics.speed float

Скорость динамической палитры или эффекта. Скорость допустима для динамической палитры, если состояние dynamic_palette или для соответствующего эффекта, указанного в состоянии. В случае состояния нет, скорость недействительна.

Допустимая скорость
data.dynamics.speed_valid boolean

Указывает, допустимо ли значение, представленное в скорости.

Состояние
data.dynamics.status string

Текущее состояние лампы с динамикой.

Значения состояния
data.dynamics.status_values array of string

Состояния, в которых лампа может быть при воспроизведении динамики.

Идентификатор ресурса
data.id string

Уникальный идентификатор, представляющий конкретный экземпляр ресурса.

Идентификатор ресурса "Клип версии 1"
data.id_v1 string

Идентификатор ресурса клипа версии 1 (версия API версии 1).

Прототип
data.metadata.archetype string

Свет архетипа. Не рекомендуется: используйте архетип на уровне устройства.

Указанное имя устройства
data.metadata.name string

Доступное для чтения имя ресурса.

Mode
data.mode string

Один из: обычный или потоковой передачи.

Состояние света
data.on.on boolean

Вкл./Выкл. Состояние света: on=true, off=false.

RID
data.owner.rid string

Уникальный идентификатор указанного ресурса.

Rtype
data.owner.rtype string

Тип указанного ресурса.

Тип
data.type string

Тип поддерживаемых ресурсов.

Получение сцен

Получение списка всех сцен. Сцены используются для хранения и отзыва параметров для группы огней.

Возвращаемое значение

Имя Путь Тип Описание
Ошибки
errors array of object

Ошибки, возникшие во время вызова.

Описание ошибки
errors.description string

Понятное для человека объяснение, конкретное для этого возникновения проблемы.

данные
data array of object

Данные.

Действия
data.actions array of object

Список действий, выполняемых на сцене.

X
data.actions.action.color.xy.x float

Минимум: 0 – максимум: 1. Положение X в цветовой гамме.

У
data.actions.action.color.xy.y float

Минимум: 0 – максимум: 1. Позиция Y в цветовой гамме.

Яркость
data.actions.action.dimming.brightness float

Максимум: 100. Процент яркости. Запись 0 изменяет ее на наименьшую возможную яркость.

Включено
data.actions.action.on.on boolean

Вкл./Выкл. Состояние освещения on=true, off=false.

Мирек
data.actions.action.color_temperature.mirek integer

Минимум: 153 – максимум: 500. Цветовая температура в мираке или null, если светлый цвет не находится в спектре ct.

избавлять
data.actions.target.rid string

Уникальный идентификатор указанного ресурса.

rtype
data.actions.target.rtype string

Тип указанного ресурса.

избавлять
data.group.rid string

Уникальный идентификатор указанного ресурса.

rtype
data.group.rtype string

Тип указанного ресурса.

Идентификатор
data.id string

Уникальный идентификатор, представляющий конкретный экземпляр ресурса.

Идентификатор версии 1
data.id_v1 string

Идентификатор ресурса клипа версии 1 (для использования в API версии 1).

избавлять
data.metadata.image.rid string

Уникальный идентификатор указанного ресурса.

rtype
data.metadata.image.rtype string

Тип указанного ресурса.

Имя
data.metadata.name string

Доступное для чтения имя ресурса.

Цвет
data.palette.color array of object
X
data.palette.color.color.xy.x float

Минимум: 0 – максимум: 1. Положение X в цветовой гамме.

У
data.palette.color.color.xy.y float

Минимум: 0 – максимум: 1. Позиция Y в цветовой гамме.

Яркость
data.palette.color.dimming.brightness float

Максимум: 100. Процент яркости. Запись 0 изменяет ее на наименьшую возможную яркость.

Цветовая температура
data.palette.color_temperature array of object
Мирек
data.palette.color_temperature.color_temperature.mirek integer

Минимум: 153 – максимум: 500. Цветовая температура в мираке или null, если светлый цвет не находится в спектре ct.

Яркость
data.palette.color_temperature.dimming.brightness float

Максимум: 100. Процент яркости. Запись 0 изменяет ее на наименьшую возможную яркость.

Затемнения
data.palette.dimming array of object
Яркость
data.palette.dimming.brightness float

Максимум: 100. Процент яркости. Запись 0 изменяет ее на наименьшую возможную яркость.

Скорость
data.speed float

Скорость динамической палитры для этой сцены.

Тип
data.type string

Тип поддерживаемых ресурсов.

Получение сцены

Получение сведений о конкретной сцене.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сцены
SceneId True string

Идентификатор сцены для отображения сведений.

Возвращаемое значение

Имя Путь Тип Описание
Ошибки
errors array of object

Ошибки, возникшие во время вызова.

Описание ошибки
errors.description string

Понятное для человека объяснение, конкретное для этого возникновения проблемы.

данные
data array of object

Данные.

Действия
data.actions array of object

Список действий, выполняемых на сцене.

X
data.actions.action.color.xy.x float

Минимум: 0 – максимум: 1. Положение X в цветовой гамме.

У
data.actions.action.color.xy.y float

Минимум: 0 – максимум: 1. Позиция Y в цветовой гамме.

Яркость
data.actions.action.dimming.brightness float

Максимум: 100. Процент яркости. Запись 0 изменяет ее на наименьшую возможную яркость.

Включено
data.actions.action.on.on boolean

Вкл./Выкл. Состояние освещения on=true, off=false.

Мирек
data.actions.action.color_temperature.mirek integer

Минимум: 153 – максимум: 500. Цветовая температура в мираке или null, если светлый цвет не находится в спектре ct.

избавлять
data.actions.target.rid string

Уникальный идентификатор указанного ресурса.

rtype
data.actions.target.rtype string

Тип указанного ресурса.

избавлять
data.group.rid string

Уникальный идентификатор указанного ресурса.

rtype
data.group.rtype string

Тип указанного ресурса.

Идентификатор
data.id string

Уникальный идентификатор, представляющий конкретный экземпляр ресурса.

Идентификатор версии 1
data.id_v1 string

Идентификатор ресурса клипа версии 1 (для использования в API версии 1).

избавлять
data.metadata.image.rid string

Уникальный идентификатор указанного ресурса.

rtype
data.metadata.image.rtype string

Тип указанного ресурса.

Имя
data.metadata.name string

Доступное для чтения имя ресурса.

Цвет
data.palette.color array of object
X
data.palette.color.color.xy.x float

Минимум: 0 – максимум: 1. Положение X в цветовой гамме.

У
data.palette.color.color.xy.y float

Минимум: 0 – максимум: 1. Позиция Y в цветовой гамме.

Яркость
data.palette.color.dimming.brightness float

Максимум: 100. Процент яркости. Запись 0 изменяет ее на наименьшую возможную яркость.

Цветовая температура
data.palette.color_temperature array of object
Мирек
data.palette.color_temperature.color_temperature.mirek integer

Минимум: 153 – максимум: 500. Цветовая температура в мираке или null, если светлый цвет не находится в спектре ct.

Яркость
data.palette.color_temperature.dimming.brightness float

Максимум: 100. Процент яркости. Запись 0 изменяет ее на наименьшую возможную яркость.

Затемнения
data.palette.dimming array of object
Яркость
data.palette.dimming.brightness float

Максимум: 100. Процент яркости. Запись 0 изменяет ее на наименьшую возможную яркость.

Скорость
data.speed float

Скорость динамической палитры для этой сцены.

Тип
data.type string

Тип поддерживаемых ресурсов.

Получение устройств

Получение списка всех устройств.

Возвращаемое значение

Имя Путь Тип Описание
Ошибки
errors array of object

Ошибки, возникшие во время вызова.

Описание ошибки
errors.description string

Понятное для человека объяснение, конкретное для этого возникновения проблемы.

данные
data array of object

Пользовательские устройства.

Идентификатор
data.id string

Уникальный идентификатор, представляющий конкретный экземпляр ресурса.

Идентификатор версии 1
data.id_v1 string

Идентификатор ресурса клипа версии 1 (для использования в API версии 1).

Прототип
data.metadata.archetype string

Архетип по умолчанию, заданный производителем.

Имя
data.metadata.name string

Доступное для чтения имя ресурса.

Заверенный
data.product_data.certified boolean

Это устройство сертифицировано HUE.

Имя производителя
data.product_data.manufacturer_name string

Имя производителя устройства.

Идентификатор модели
data.product_data.model_id string

уникальная идентификация модели устройства.

Архетип продукта
data.product_data.product_archetype string

Архетип продукта.

Название продукта
data.product_data.product_name string

Имя продукта.

Версия программного обеспечения
data.product_data.software_version string

Версия программного обеспечения продукта.

Services
data.services array of object

Ссылается на все службы, агрегирующие управление и состояние дочерних элементов в группе.

избавлять
data.services.rid string

Уникальный идентификатор указанного ресурса.

rtype
data.services.rtype string

Тип указанного ресурса.

Тип
data.type string

Тип поддерживаемого ресурса.

Получение устройства

Получение сведений о конкретном устройстве.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор устройства
DeviceId True string

Идентификатор устройства для отображения сведений.

Возвращаемое значение

Имя Путь Тип Описание
Ошибки
errors array of object

Ошибки, возникшие во время вызова.

Описание ошибки
errors.description string

Понятное для человека объяснение, конкретное для этого возникновения проблемы.

данные
data array of object

Устройства, соответствующие заданному идентификатору.

Идентификатор
data.id string

Уникальный идентификатор, представляющий конкретный экземпляр ресурса.

Идентификатор версии 1
data.id_v1 string

Идентификатор ресурса клипа версии 1 (для использования в API версии 1).

Прототип
data.metadata.archetype string

Архетип по умолчанию, заданный производителем.

Имя
data.metadata.name string

Доступное для чтения имя ресурса.

Заверенный
data.product_data.certified boolean

Это устройство сертифицировано HUE.

Имя производителя
data.product_data.manufacturer_name string

Имя производителя устройства.

Идентификатор модели
data.product_data.model_id string

уникальная идентификация модели устройства.

Архетип продукта
data.product_data.product_archetype string

Архетип продукта.

Название продукта
data.product_data.product_name string

Имя продукта.

Версия программного обеспечения
data.product_data.software_version string

Версия программного обеспечения продукта.

Services
data.services array of object

Ссылается на все службы, агрегирующие управление и состояние дочерних элементов в группе.

избавлять
data.services.rid string

Уникальный идентификатор указанного ресурса.

rtype
data.services.rtype string

Тип указанного ресурса.

Тип
data.type string

Тип поддерживаемого ресурса.

Удаление сцены

Удаление определенной сцены.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сцены
SceneId True string

Идентификатор сцены для удаления.

Возвращаемое значение

Имя Путь Тип Описание
данные
data array of object

Обновленные сцены.

избавлять
data.rid string

Уникальный идентификатор удаленной сцены.

rtype
data.rtype string

Тип удаленной сцены.

Ошибки
errors array of object

Ошибки, возникшие во время вызова.

Описание ошибки
errors.description string

Понятное для человека объяснение, конкретное для этого возникновения проблемы.