共用方式為

飛利浦 HUE（獨立出版商）

飛利浦 HUE 允許您控制智能家居設備，例如飛利浦製造的燈、開關、插頭等。

此連接器適用於以下產品和區域：

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 （DoD）
Power Apps 進階 除下列區域外的所有 Power Apps 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
Power Automate（自動化服務） 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
連絡人​​
名稱 托馬斯·波西泰克
URL https://aka.ms/poszytek
Email tomasz@poszytek.eu
連接器中繼資料
Publisher 托馬斯·波西泰克
網站 https://www.philips-hue.com/
隱私策略 https://www.philips-hue.com/en-us/support/legal/privacy-policy
類別 物聯網;生活方式和娛樂

正在建立連線

連接器支援下列驗證類型：
預設值 建立連線的參數。 所有區域 不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
HUE 應用程式金鑰 securestring 執行 PUT 和 POST 授權呼叫之後傳回的 API 金鑰。 對

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

刪除場景

刪除特定場景。
取得場景

取得特定場景的詳細資料。
取得場景

獲取所有場景的列表。 場景用於儲存和呼叫一組燈源的設定。
取得裝置

取得特定裝置的詳細資料。
取得裝置

獲取您所有設備的列表。
執行裝置

執行特定裝置。
執行輕型

執行具有閃電功能的設備。
獲取房間

取得房間（群組）清單。
獲取燈光

獲取具有閃電功能的設備列表。
輕裝上陣

取得具有閃電功能的特定裝置的詳細資料。

刪除場景

作業識別碼：
DeleteScene

刪除特定場景。

參數

名稱 機碼 必要 類型 Description
場景 ID
 SceneId True string

要刪除的場景的 ID。

傳回

名稱 路徑 類型 Description
資料
 data array of object

更新了場景。
擺脫
 data.rid string

已刪除場景的唯一識別碼。
R類型
 data.rtype string

已刪除場景的類型。
錯誤
 errors array of object

通話期間發生的錯誤。
錯誤描述
 errors.description string

針對此問題發生的特定人類可讀解釋。

取得場景

作業識別碼：
GetScene

取得特定場景的詳細資料。

參數

名稱 機碼 必要 類型 Description
場景 ID
 SceneId True string

要顯示詳細資料的場景標識碼。

傳回

名稱 路徑 類型 Description
錯誤
 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。 當光色不在 ct 光譜中時，色溫為 mirek 或 null。
擺脫
 data.actions.target.rid string

參考資源的唯一 ID。
R類型
 data.actions.target.rtype string

參考資源的類型。
擺脫
 data.group.rid string

參考資源的唯一 ID。
R類型
 data.group.rtype string

參考資源的類型。
Id
 data.id string

代表特定資源實例的唯一識別碼。
標識 v1
 data.id_v1 string

剪輯 v1 資源識別碼 （要用於 API v1）。
擺脫
 data.metadata.image.rid string

參考資源的唯一 ID。
R類型
 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。 當光色不在 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 會將其更改為盡可能低的亮度。
速度
 data.speed float

此場景的動態調色盤速度。
類型
 data.type string

支援資源的類型。

取得場景

作業識別碼：
GetScenes

獲取所有場景的列表。 場景用於儲存和呼叫一組燈源的設定。

傳回

名稱 路徑 類型 Description
錯誤
 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。 當光色不在 ct 光譜中時，色溫為 mirek 或 null。
擺脫
 data.actions.target.rid string

參考資源的唯一 ID。
R類型
 data.actions.target.rtype string

參考資源的類型。
擺脫
 data.group.rid string

參考資源的唯一 ID。
R類型
 data.group.rtype string

參考資源的類型。
Id
 data.id string

代表特定資源實例的唯一識別碼。
標識 v1
 data.id_v1 string

剪輯 v1 資源識別碼 （要用於 API v1）。
擺脫
 data.metadata.image.rid string

參考資源的唯一 ID。
R類型
 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。 當光色不在 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 會將其更改為盡可能低的亮度。
速度
 data.speed float

此場景的動態調色盤速度。
類型
 data.type string

支援資源的類型。

取得裝置

作業識別碼：
GetDevice

取得特定裝置的詳細資料。

參數

名稱 機碼 必要 類型 Description
裝置識別碼
 DeviceId True string

要顯示詳細資料的裝置識別碼。

傳回

名稱 路徑 類型 Description
錯誤
 errors array of object

通話期間發生的錯誤。
錯誤描述
 errors.description string

針對此問題發生的特定人類可讀解釋。
資料
 data array of object

符合指定 ID 的裝置。
Id
 data.id string

代表特定資源實例的唯一識別碼。
標識 v1
 data.id_v1 string

剪輯 v1 資源識別碼 （要用於 API v1）。
原型
 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

參考資源的唯一 ID。
R類型
 data.services.rtype string

參考資源的類型。
類型
 data.type string

支援資源的類型。

取得裝置

作業識別碼：
GetDevices

獲取您所有設備的列表。

傳回

名稱 路徑 類型 Description
錯誤
 errors array of object

通話期間發生的錯誤。
錯誤描述
 errors.description string

針對此問題發生的特定人類可讀解釋。
資料
 data array of object

使用者裝置。
Id
 data.id string

代表特定資源實例的唯一識別碼。
標識 v1
 data.id_v1 string

剪輯 v1 資源識別碼 （要用於 API v1）。
原型
 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

參考資源的唯一 ID。
R類型
 data.services.rtype string

參考資源的類型。
類型
 data.type string

支援資源的類型。

執行裝置

作業識別碼：
ExecuteDevice

執行特定裝置。

參數

名稱 機碼 必要 類型 Description
裝置識別碼
 DeviceId True string

要更新中繼資料的裝置識別碼。
原型
 archetype string

默認原型由製造商給出。
名稱
 name string

資源的人類可讀名稱 （最多 32 個字元）。
行動
 action string

輸入「識別」以觸發識別。 Bridge 執行 Zigbee LED 識別週期 5 秒。 燈光執行一個呼吸週期。 感測器執行 LED 識別週期 15 秒。

傳回

名稱 路徑 類型 Description
資料
 data array of object

更新的設備。
擺脫
 data.rid string

參考資源的唯一 ID。
R類型
 data.rtype string

參考資源的類型。
錯誤
 errors array of object

通話期間發生的錯誤。
錯誤描述
 errors.description string

針對此問題發生的特定人類可讀解釋。

執行輕型

作業識別碼：
ExecuteLight

執行具有閃電功能的設備。

參數

名稱 機碼 必要 類型 Description
裝置識別碼
 DeviceId True string

要更新屬性的裝置識別碼。
名稱
 name string

最小長度：1 - 最大長度：32。 資源的人類可讀名稱。
另一
 on boolean

燈的開/關狀態 on=true，off=false。
亮度
 brightness float

最大值：100。 亮度百分比。 寫 0 會將其更改為盡可能低的亮度。
米雷克
 mirek integer

最小值：153 - 最大值：500。 當光色不在 ct 光譜中時，色溫為 mirek 或 null。
X
 x float

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

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

最小值：0 - 最大值：1。 動態調色板的速度。 如果狀態為dynamic_palette，則速度對動態調色盤有效，或對狀態中列出的對應效果有效。 如果狀態為none，則速度無效。
持續時間
 duration integer

最高：6000000。 光轉換的持續時間（以毫秒為單位）。 精度以 100 毫秒為單位。
行動
 action string

在裝置上執行的可用動作之一。 即“呼吸”。
X
 x float

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

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

傳回

名稱 路徑 類型 Description
資料
 data array of object

資料
擺脫
 data.rid string

擺脫
R類型
 data.rtype string

R類型
錯誤
 errors array of object

通話期間發生的錯誤。
錯誤描述
 errors.description string

針對此問題發生的特定人類可讀解釋。

獲取房間

作業識別碼：
GetRooms

取得房間（群組）清單。

傳回

名稱 路徑 類型 Description
錯誤
 errors array of object

通話期間發生的錯誤。
錯誤描述
 errors.description string

針對此問題發生的特定人類可讀解釋。
資料
 data array of object

資料。
孩童
 data.children array of object

要按會議室分組的裝置。 允許以下兒童：“設備”。
擺脫
 data.children.rid string

所建立場景的唯一 ID。
R類型
 data.children.rtype string

所建立場景的類型。
分組服務
 data.grouped_services array of object

彙總控制服務的參照。 已棄用：使用服務。
擺脫
 data.grouped_services.rid string

所建立場景的唯一 ID。
R類型
 data.grouped_services.rtype string

所建立場景的類型。
Id
 data.id string

代表特定資源實例的唯一識別碼。
標識 v1
 data.id_v1 string

剪輯 v1 資源識別碼 （要用於 API v1）。
原型
 data.metadata.archetype string

製造商給出的默認原型。
名稱
 data.metadata.name string

資源的人類可讀名稱。
Services
 data.services array of object

參考彙總群組中子系控制和狀態的所有服務。 聚合是根據服務類型進行的，即每個可以分組的服務類型都有相應的分組類型定義。 支援的類型：「輕型」。
擺脫
 data.services.rid string

所建立場景的唯一 ID。
R類型
 data.services.rtype string

所建立場景的類型。
類型
 data.type string

支援資源的類型。

獲取燈光

作業識別碼：
GetLights

獲取具有閃電功能的設備列表。

傳回

名稱 路徑 類型 Description
錯誤
 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 位置。
色域類型
 data.color.gamut_type string

色相支援的色域類型：A - 早期飛利浦純色產品的色域，B - 第一款色相顏色產品的有限色域，C - 色相白色和色彩氛圍產品的色域更豐富，其他 - 非色相產品的色域。
X
 data.color.xy.x float

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

色域中的 Y 位置。
米雷克
 data.color_temperature.mirek integer

當光色不在 ct 光譜中時，色溫為 mirek 或 null。
米雷克最大值
 data.color_temperature.mirek_schema.mirek_maximum integer

該燈支持的最大色溫。
米雷克最小值
 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

裝置在最低亮度下輸出的最大流明百分比。
速度
 data.dynamics.speed float

動態調色板或效果的速度。 如果狀態為dynamic_palette，則速度對動態調色盤有效，或對狀態中列出的對應效果有效。 如果狀態為none，則速度無效。
速度有效
 data.dynamics.speed_valid boolean

指出以速度呈現的值是否有效。
地位
 data.dynamics.status string

燈的當前狀態與動態。
狀態值
 data.dynamics.status_values array of string

播放動態時燈可能處於的狀態。
資源識別碼
 data.id string

代表特定資源實例的唯一識別碼。
剪輯 v1 資源識別碼
 data.id_v1 string

剪輯 v1 資源識別碼 （v1 API 版本）。
原型
 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

參考資源的唯一 ID。
R類型
 data.owner.rtype string

參考資源的類型。
類型
 data.type string

支援資源的類型。

輕裝上陣

作業識別碼：
GetLight

取得具有閃電功能的特定裝置的詳細資料。

參數

名稱 機碼 必要 類型 Description
裝置識別碼
 DeviceId True string

要顯示詳細資料的裝置識別碼。

傳回

名稱 路徑 類型 Description
錯誤
 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 位置。
色域類型
 data.color.gamut_type string

色相支援的色域類型：A - 早期飛利浦純色產品的色域，B - 第一款色相顏色產品的有限色域，C - 色相白色和色彩氛圍產品的色域更豐富，其他 - 非色相產品的色域。
X
 data.color.xy.x float

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

色域中的 Y 位置。
米雷克
 data.color_temperature.mirek integer

當光色不在 ct 光譜中時，色溫為 mirek 或 null。
米雷克最大值
 data.color_temperature.mirek_schema.mirek_maximum integer

該燈支持的最大色溫。
米雷克最小值
 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

裝置在最低亮度下輸出的最大流明百分比。
速度
 data.dynamics.speed float

動態調色板或效果的速度。 如果狀態為dynamic_palette，則速度對動態調色盤有效，或對狀態中列出的對應效果有效。 如果狀態為none，則速度無效。
速度有效
 data.dynamics.speed_valid boolean

指出以速度呈現的值是否有效。
地位
 data.dynamics.status string

燈的當前狀態與動態。
狀態值
 data.dynamics.status_values array of string

播放動態時燈可能處於的狀態。
資源識別碼
 data.id string

代表特定資源實例的唯一識別碼。
剪輯 v1 資源識別碼
 data.id_v1 string

剪輯 v1 資源識別碼 （v1 API 版本）。
原型
 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

參考資源的唯一 ID。
R類型
 data.owner.rtype string

參考資源的類型。
類型
 data.type string

支援資源的類型。