通过

Philips HUE （独立出版商）

借助 Philips HUE，你可以控制智能家庭设备，如灯、开关、插电等由 Philips 构建的更多设备。

此连接器在以下产品和区域中可用：

服务 Class 区域
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 ：
     - Azure 政府区域
     - Azure 中国区域
     - 美国国防部（DoD）
Power Apps 高级 除以下各项外的所有 Power Apps 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
Power Automate 高级 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
联系人​​
Name Tomasz Poszytek
URL https://aka.ms/poszytek
Email tomasz@poszytek.eu
连接器元数据
发布者 Tomasz Poszytek
Website https://www.philips-hue.com/
隐私策略 https://www.philips-hue.com/en-us/support/legal/privacy-policy
类别 物联网;生活方式和娱乐

正在创建连接

连接器支持以下身份验证类型：
默认 用于创建连接的参数。 所有区域 不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name 类型 Description 必选
HUE 应用程序密钥 securestring 执行 PUT 和 POST 授权调用后返回的 API 密钥。 True

限制

名称 调用 续订期
每个连接的 API 调用数 100 60 秒

操作

删除场景

删除特定场景。
执行光

执行具有闪电功能的设备。
执行设备

执行特定设备。
获取会议室

获取会议室列表（组）。
获取光线

获取具有闪电功能的特定设备的详细信息。
获取场景

获取特定场景的详细信息。
获取场景

获取所有场景的列表。 场景用于存储和召回一组灯光的设置。
获取灯

获取具有闪电功能的设备列表。
获取设备

获取特定设备的详细信息。
获取设备

获取所有设备的列表。

删除场景

操作 ID:
DeleteScene

删除特定场景。

参数

名称 密钥 必需 类型 说明
场景 ID
 SceneId True string

要删除的场景的 ID。

返回

名称 路径 类型 说明
数据
 data array of object

更新的场景。
摆脱
 data.rid string

已删除场景的唯一 ID。
rtype
 data.rtype string

已删除场景的类型。
错误
 errors array of object

调用期间发生的错误。
错误描述
 errors.description string

特定于此问题的可读说明。

执行光

操作 ID:
ExecuteLight

执行具有闪电功能的设备。

参数

名称 密钥 必需 类型 说明
设备 ID
 DeviceId True string

要更新属性的设备 ID。
Name
 name string

MinLength： 1 - maxLength： 32. 资源的可读名称。
启用
 on boolean

浅色 on=true 的 On/Off 状态，off=false。
亮度
 brightness float

最大值：100。 亮度百分比。 写入 0 会将它更改为尽可能低的亮度。
Mirek
 mirek integer

最小值：153 - 最大值：500。 当浅色不在 ct 光谱中时，颜色温度为 mirek 或 null。
X
 x float

最小值：0 - 最大值：1。 颜色域中的 X 位置。
Y
 y float

最小值：0 - 最大值：1。 颜色域中的 Y 位置。
Speed
 speed float

最小值：0 - 最大值：1。 动态调色板的速度。 如果状态dynamic_palette或状态中列出的相应效果，则速度对于动态调色板有效。 如果状态为 none，则速度无效。
持续时间
 duration integer

最大值：6000000。 以 ms 为单位的浅色转换持续时间。 准确性以 100 毫秒为单位。
Action
 action string

在设备上执行的可用作之一。 即“呼吸”。
X
 x float

最小值：0 - 最大值：1。 颜色域中的 X 位置。
Y
 y float

最小值：0 - 最大值：1。 颜色域中的 Y 位置。

返回

名称 路径 类型 说明
数据
 data array of object

数据
摆脱
 data.rid string

摆脱
rtype
 data.rtype string

rtype
错误
 errors array of object

调用期间发生的错误。
错误描述
 errors.description string

特定于此问题的可读说明。

执行设备

操作 ID:
ExecuteDevice

执行特定设备。

参数

名称 密钥 必需 类型 说明
设备 ID
 DeviceId True string

要更新元数据的设备 ID。
原型
 archetype string

默认情况下，制造商给出的原型。
Name
 name string

资源的人类可读名称（最多 32 个字符）。
Action
 action string

键入“标识”以触发标识。 桥执行 Zigbee LED 识别周期 5 秒。 灯光执行一个呼吸周期。 传感器执行 LED 识别周期 15 秒。

返回

名称 路径 类型 说明
数据
 data array of object

更新了设备。
摆脱
 data.rid string

所引用资源的唯一 ID。
rtype
 data.rtype string

引用的资源的类型。
错误
 errors array of object

调用期间发生的错误。
错误描述
 errors.description string

特定于此问题的可读说明。

获取会议室

操作 ID:
GetRooms

获取会议室列表（组）。

返回

名称 路径 类型 说明
错误
 errors array of object

调用期间发生的错误。
错误描述
 errors.description string

特定于此问题的可读说明。
数据
 data array of object

数据。
Children
 data.children array of object

按会议室分组的设备。 允许以下子级：“device”。
摆脱
 data.children.rid string

创建场景的唯一 ID。
rtype
 data.children.rtype string

创建的场景的类型。
分组服务
 data.grouped_services array of object

对聚合控件服务的引用。 已弃用：使用服务。
摆脱
 data.grouped_services.rid string

创建场景的唯一 ID。
rtype
 data.grouped_services.rtype string

创建的场景的类型。
Id
 data.id string

表示特定资源实例的唯一标识符。
Id v1
 data.id_v1 string

剪辑 v1 资源标识符（用于 API v1）。
原型
 data.metadata.archetype string

制造商提供的默认原型。
Name
 data.metadata.name string

资源的可读名称。
Services
 data.services array of object

引用聚合组中子级控件和状态的所有服务。 聚合按服务类型（即可以分组的每个服务类型）具有相应的分组类型定义。 支持的类型：“light”。
摆脱
 data.services.rid string

创建场景的唯一 ID。
rtype
 data.services.rtype string

创建的场景的类型。
类型
 data.type string

支持的资源的类型。

获取光线

操作 ID:
GetLight

获取具有闪电功能的特定设备的详细信息。

参数

名称 密钥 必需 类型 说明
设备 ID
 DeviceId True string

要显示详细信息的设备 ID。

返回

名称 路径 类型 说明
错误
 errors array of object

调用期间发生的错误。
错误描述
 errors.description string

特定于此问题的可读说明。
数据
 data array of object

与给定 ID 匹配的灯。
作值
 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 - 早期菲利普纯色产品的范围，B - 第一种 Hue 颜色产品的有限域，C - 色调白色的更丰富色域和彩色色调产品，其他 - 非色调产品的色域。
X
 data.color.xy.x float

颜色域中的 X 位置。
Y
 data.color.xy.y float

颜色域中的 Y 位置。
Mirek
 data.color_temperature.mirek integer

当浅色不在 ct 光谱中时，颜色温度为 mirek 或 null。
Mirek 最大值
 data.color_temperature.mirek_schema.mirek_maximum integer

此光支持的最大颜色温度。
Mirek 最小值
 data.color_temperature.mirek_schema.mirek_minimum integer

此光支持的最低颜色温度。
Mirek 有效
 data.color_temperature.mirek_valid boolean

指示 mirek 中显示的值是否有效。
亮度
 data.dimming.brightness float

亮度百分比。 值不能为 0，写入 0 会将该值更改为尽可能低的亮度。
最小暗度级别
 data.dimming.min_dim_level float

设备在最小亮度上输出的最大亮度百分比。
Speed
 data.dynamics.speed float

动态调色板或效果的速度。 如果状态dynamic_palette或状态中列出的相应效果，则速度对于动态调色板有效。 如果状态为 none，则速度无效。
速度有效
 data.dynamics.speed_valid boolean

指示以速度显示的值是否有效。
状态
 data.dynamics.status string

具有动态的灯的当前状态。
状态值
 data.dynamics.status_values array of string

播放动态时灯的状态。
资源 ID
 data.id string

表示特定资源实例的唯一标识符。
剪辑 v1 资源 ID
 data.id_v1 string

剪辑 v1 资源标识符（v1 API 版本）。
原型
 data.metadata.archetype string

浅原型。 已弃用：在设备级别使用原型。
设备给定名称
 data.metadata.name string

资源的可读名称。
模式
 data.mode string

其中一个：普通或流式处理。
浅色状态
 data.on.on boolean

浅色的 On/Off 状态：on=true、off=false。
RID
 data.owner.rid string

所引用资源的唯一 ID。
Rtype
 data.owner.rtype string

引用的资源的类型。
类型
 data.type string

支持的资源的类型。

获取场景

操作 ID:
GetScene

获取特定场景的详细信息。

参数

名称 密钥 必需 类型 说明
场景 ID
 SceneId True string

用于显示详细信息的场景的 ID。

返回

名称 路径 类型 说明
错误
 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 位置。
Y
 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 的 On/Off 状态，off=false。
Mirek
 data.actions.action.color_temperature.mirek integer

最小值：153 - 最大值：500。 当浅色不在 ct 光谱中时，颜色温度为 mirek 或 null。
摆脱
 data.actions.target.rid string

所引用资源的唯一 ID。
rtype
 data.actions.target.rtype string

引用的资源的类型。
摆脱
 data.group.rid string

所引用资源的唯一 ID。
rtype
 data.group.rtype string

引用的资源的类型。
Id
 data.id string

表示特定资源实例的唯一标识符。
Id v1
 data.id_v1 string

剪辑 v1 资源标识符（用于 API v1）。
摆脱
 data.metadata.image.rid string

所引用资源的唯一 ID。
rtype
 data.metadata.image.rtype string

引用的资源的类型。
Name
 data.metadata.name string

资源的可读名称。
颜色
 data.palette.color array of object
X
 data.palette.color.color.xy.x float

最小值：0 - 最大值：1。 颜色域中的 X 位置。
Y
 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
Mirek
 data.palette.color_temperature.color_temperature.mirek integer

最小值：153 - 最大值：500。 当浅色不在 ct 光谱中时，颜色温度为 mirek 或 null。
亮度
 data.palette.color_temperature.dimming.brightness float

最大值：100。 亮度百分比。 写入 0 会将它更改为尽可能低的亮度。
变 暗
 data.palette.dimming array of object
亮度
 data.palette.dimming.brightness float

最大值：100。 亮度百分比。 写入 0 会将它更改为尽可能低的亮度。
Speed
 data.speed float

此场景的动态调色板的速度。
类型
 data.type string

支持的资源的类型。

获取场景

操作 ID:
GetScenes

获取所有场景的列表。 场景用于存储和召回一组灯光的设置。

返回

名称 路径 类型 说明
错误
 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 位置。
Y
 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 的 On/Off 状态，off=false。
Mirek
 data.actions.action.color_temperature.mirek integer

最小值：153 - 最大值：500。 当浅色不在 ct 光谱中时，颜色温度为 mirek 或 null。
摆脱
 data.actions.target.rid string

所引用资源的唯一 ID。
rtype
 data.actions.target.rtype string

引用的资源的类型。
摆脱
 data.group.rid string

所引用资源的唯一 ID。
rtype
 data.group.rtype string

引用的资源的类型。
Id
 data.id string

表示特定资源实例的唯一标识符。
Id v1
 data.id_v1 string

剪辑 v1 资源标识符（用于 API v1）。
摆脱
 data.metadata.image.rid string

所引用资源的唯一 ID。
rtype
 data.metadata.image.rtype string

引用的资源的类型。
Name
 data.metadata.name string

资源的可读名称。
颜色
 data.palette.color array of object
X
 data.palette.color.color.xy.x float

最小值：0 - 最大值：1。 颜色域中的 X 位置。
Y
 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
Mirek
 data.palette.color_temperature.color_temperature.mirek integer

最小值：153 - 最大值：500。 当浅色不在 ct 光谱中时，颜色温度为 mirek 或 null。
亮度
 data.palette.color_temperature.dimming.brightness float

最大值：100。 亮度百分比。 写入 0 会将它更改为尽可能低的亮度。
变 暗
 data.palette.dimming array of object
亮度
 data.palette.dimming.brightness float

最大值：100。 亮度百分比。 写入 0 会将它更改为尽可能低的亮度。
Speed
 data.speed float

此场景的动态调色板的速度。
类型
 data.type string

支持的资源的类型。

获取灯

操作 ID:
GetLights

获取具有闪电功能的设备列表。

返回

名称 路径 类型 说明
错误
 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 - 早期菲利普纯色产品的范围，B - 第一种 Hue 颜色产品的有限域，C - 色调白色的更丰富色域和彩色色调产品，其他 - 非色调产品的色域。
X
 data.color.xy.x float

颜色域中的 X 位置。
Y
 data.color.xy.y float

颜色域中的 Y 位置。
Mirek
 data.color_temperature.mirek integer

当浅色不在 ct 光谱中时，颜色温度为 mirek 或 null。
Mirek 最大值
 data.color_temperature.mirek_schema.mirek_maximum integer

此光支持的最大颜色温度。
Mirek 最小值
 data.color_temperature.mirek_schema.mirek_minimum integer

此光支持的最低颜色温度。
Mirek 有效
 data.color_temperature.mirek_valid boolean

指示 mirek 中显示的值是否有效。
亮度
 data.dimming.brightness float

亮度百分比。 值不能为 0，写入 0 会将该值更改为尽可能低的亮度。
最小暗度级别
 data.dimming.min_dim_level float

设备在最小亮度上输出的最大亮度百分比。
Speed
 data.dynamics.speed float

动态调色板或效果的速度。 如果状态dynamic_palette或状态中列出的相应效果，则速度对于动态调色板有效。 如果状态为 none，则速度无效。
速度有效
 data.dynamics.speed_valid boolean

指示以速度显示的值是否有效。
状态
 data.dynamics.status string

具有动态的灯的当前状态。
状态值
 data.dynamics.status_values array of string

播放动态时灯的状态。
资源 ID
 data.id string

表示特定资源实例的唯一标识符。
剪辑 v1 资源 ID
 data.id_v1 string

剪辑 v1 资源标识符（v1 API 版本）。
原型
 data.metadata.archetype string

浅原型。 已弃用：在设备级别使用原型。
设备给定名称
 data.metadata.name string

资源的可读名称。
模式
 data.mode string

其中一个：普通或流式处理。
浅色状态
 data.on.on boolean

浅色的 On/Off 状态：on=true、off=false。
RID
 data.owner.rid string

所引用资源的唯一 ID。
Rtype
 data.owner.rtype string

引用的资源的类型。
类型
 data.type string

支持的资源的类型。

获取设备

操作 ID:
GetDevice

获取特定设备的详细信息。

参数

名称 密钥 必需 类型 说明
设备 ID
 DeviceId True string

要显示详细信息的设备 ID。

返回

名称 路径 类型 说明
错误
 errors array of object

调用期间发生的错误。
错误描述
 errors.description string

特定于此问题的可读说明。
数据
 data array of object

与给定 ID 匹配的设备。
Id
 data.id string

表示特定资源实例的唯一标识符。
Id v1
 data.id_v1 string

剪辑 v1 资源标识符（用于 API v1）。
原型
 data.metadata.archetype string

制造商提供的默认原型。
Name
 data.metadata.name string

资源的可读名称。
认证
 data.product_data.certified boolean

此设备经过 HUE 认证。
制造商名称
 data.product_data.manufacturer_name string

设备制造商的名称。
模型 ID
 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

所引用资源的唯一 ID。
rtype
 data.services.rtype string

引用的资源的类型。
类型
 data.type string

支持的资源的类型。

获取设备

操作 ID:
GetDevices

获取所有设备的列表。

返回

名称 路径 类型 说明
错误
 errors array of object

调用期间发生的错误。
错误描述
 errors.description string

特定于此问题的可读说明。
数据
 data array of object

用户设备。
Id
 data.id string

表示特定资源实例的唯一标识符。
Id v1
 data.id_v1 string

剪辑 v1 资源标识符（用于 API v1）。
原型
 data.metadata.archetype string

制造商提供的默认原型。
Name
 data.metadata.name string

资源的可读名称。
认证
 data.product_data.certified boolean

此设备经过 HUE 认证。
制造商名称
 data.product_data.manufacturer_name string

设备制造商的名称。
模型 ID
 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

所引用资源的唯一 ID。
rtype
 data.services.rtype string

引用的资源的类型。
类型
 data.type string

支持的资源的类型。