fuchsia.hardware.light

已新增：7

專家

淺色

定義於 fuchsia.hardware.light/light.fidl

取得 CurrentBrightnessValue

傳回由索引指定的光源目前的亮度值 (0.0 - 1.0)，其中 0.0 是最低亮度，1.0 是最大值。如果這個燈號不支援「BRIGHTNESS」能力，會傳回 NOT_SUPPORTED。 使用 GetInfo 檢查光源是否支援這項作業。索引：介於 0 (含 0) 與 GetNumLights 接收的計數之間。

要求

名稱類型
index uint32

回應

名稱類型
payload Light_GetCurrentBrightnessValue_Result

取得 CurrentRgbValue

傳回單一光源目前的 RGB 值。如果這個光源不支援「RGB」能力，系統會傳回 NOT_SUPPORTED。使用 GetInfo 檢查光源是否支援這項作業。索引：介於 0 (含 0) 與 GetNumLights 接收的計數之間。

要求

名稱類型
index uint32

回應

名稱類型
payload Light_GetCurrentRgbValue_Result

GetCurrentSimpleValue

傳回目前的值。如果燈光為 True，這個值為 True。如果燈光為關閉狀態，這個值會是「False」。如果這個燈具不支援「SIMPLE」能力，會傳回 NOT_SUPPORTED。 使用 GetInfo 檢查光源是否支援這項作業。索引：介於 0 (含 0) 與 GetNumLights 接收的計數之間。

要求

名稱類型
index uint32

回應

名稱類型
payload Light_GetCurrentSimpleValue_Result

GetGroupCurrentBrightnessValue

傳回淺色群組目前亮度值 (0.0 - 1.0) 的陣列，其中最低亮度為 0.0，最高亮度為 1.0。如果 group_id 無效，會傳回 INVALID_INDEX。 如果這個群組不支援「BRIGHTNESS」能力，會傳回 NOT_SUPPORTED。 使用 GetGroupInfo 檢查群組是否支援這項作業。group_id：介於 0 與 GetNumLightGroup 收到的計數之間。

要求

名稱類型
group_id uint32

回應

名稱類型
payload Light_GetGroupCurrentBrightnessValue_Result

取得 GroupCurrentRgbValue

傳回淺色群組目前 RGB 值的陣列。如果 group_id 無效，會傳回 INVALID_INDEX。 如果這個群組不支援「RGB」能力，會傳回 NOT_SUPPORTED。 使用 GetGroupInfo 檢查群組是否支援這項作業。group_id：介於 0 與 GetNumLightGroup 收到的計數之間。

要求

名稱類型
group_id uint32

回應

名稱類型
payload Light_GetGroupCurrentRgbValue_Result

獲取群組 CurrentSimpleValue

傳回目前值的陣列。如果燈具開啟，值為 True。如果指示燈為關閉狀態，這個值為「False」。如果 group_id 無效，會傳回 INVALID_INDEX。 如果這個群組不支援「SIMPLE」能力，會傳回 NOT_SUPPORTED。 使用 GetGroupInfo 檢查群組是否支援這項作業。group_id：介於 0 與 GetNumLightGroup 收到的計數之間。

要求

名稱類型
group_id uint32

回應

名稱類型
payload Light_GetGroupCurrentSimpleValue_Result

取得群組資訊

傳回淺色群組的群組資訊。 group_id：介於 0 之間的數字 (含 0 和 GetNumLightGroup 的接收數量)。

要求

名稱類型
group_id uint32

回應

名稱類型
payload Light_GetGroupInfo_Result

取得資訊

傳回單一光源的資訊。 索引：電路板定義的光源索引。必須小於 GetNumLights 傳回的值。

要求

名稱類型
index uint32

回應

名稱類型
payload Light_GetInfo_Result

取得 NumLightGroup

傳回燈具群組總數 (不會計算單一燈具)。淺色群組則是在下列呼叫中使用「group_id」參數。

要求

<空白>

回應

名稱類型
count uint32

GetNumLight

傳回實體燈具的總數。對於簡單的 LED 燈，這通常為 1，但如果是一系列光源或較複雜的照明裝置，這個值可能會大於 1。 系統會在下列呼叫中，使用「index」參數讓多個燈具定位。

要求

<空白>

回應

名稱類型
count uint32

SetBrightnessValue

設定目前的亮度值 (0.0 - 1.0)，其中 0.0 為最低亮度，1.0 為最大值。如果這個燈號不支援「BRIGHTNESS」能力，會傳回 NOT_SUPPORTED。 使用 GetInfo 檢查光源是否支援這項作業。索引：介於 0 (含 0) 與 GetNumLights 接收的計數之間。

要求

名稱類型
index uint32
value float64

回應

名稱類型
payload Light_SetBrightnessValue_Result

SetGroupBrightnessValue

透過值陣列，設定亮燈組目前的亮度值 (0.0 - 1.0)，其中 0.0 是最低亮度，1.0 是最大值。如果 group_id 無效，會傳回 INVALID_INDEX。 如果這個群組不支援「BRIGHTNESS」能力，會傳回 NOT_SUPPORTED。 使用 GetGroupInfo 檢查群組是否支援這項作業。group_id：介於 0 與 GetNumLightGroup 收到的計數之間。

要求

名稱類型
group_id uint32
values vector<float64>

回應

名稱類型
payload Light_SetGroupBrightnessValue_Result

SetGroupRgbValue

設定淺色群組目前的 RGB 值。如果 group_id 無效，會傳回 INVALID_INDEX。 如果這個群組不支援「RGB」能力，會傳回 NOT_SUPPORTED。 使用 GetGroupInfo 檢查群組是否支援這項作業。group_id：介於 0 與 GetNumLightGroup 收到的計數之間。

要求

名稱類型
group_id uint32
values vector<Rgb>

回應

名稱類型
payload Light_SetGroupRgbValue_Result

SetGroupSimpleValue

透過值陣列設定目前的值。值應設為「TRUE」即可開啟燈。值應設為「FALSE」可關燈。 如果 group_id 無效，會傳回 INVALID_INDEX。 如果這個群組不支援「SIMPLE」能力，會傳回 NOT_SUPPORTED。 使用 GetGroupInfo 檢查群組是否支援這項作業。group_id：介於 0 與 GetNumLightGroup 收到的計數之間。

要求

名稱類型
group_id uint32
values vector<bool>

回應

名稱類型
payload Light_SetGroupSimpleValue_Result

SetRgbValue

設定目前的 RGB 值。如果這個光源不支援「RGB」能力，系統會傳回 NOT_SUPPORTED。使用 GetInfo 檢查光源是否支援這項作業。索引：介於 0 (含 0) 與 GetNumLights 接收的計數之間。

要求

名稱類型
index uint32
value Rgb

回應

名稱類型
payload Light_SetRgbValue_Result

設定簡單值

設定目前的值。值應設為「TRUE」即可開啟燈。值應設為「FALSE」可關閉燈。如果這個燈具不支援「SIMPLE」能力，會傳回 NOT_SUPPORTED。 使用 GetInfo 檢查光源是否支援這項作業。索引：介於 0 (含 0) 與 GetNumLights 接收的計數之間。

要求

名稱類型
index uint32
value bool

回應

名稱類型
payload Light_SetSimpleValue_Result

結構

群組資訊

定義於 fuchsia.hardware.light/light.fidl

欄位類型說明預設
name string[32] 無預設
count uint32 無預設
capability Capability 無預設

資訊

定義於 fuchsia.hardware.light/light.fidl

欄位類型說明預設
name string[32] 無預設
capability Capability 無預設

Light_GetCurrentBrightnessValue_Response

定義於 fuchsia.hardware.light/light.fidl

欄位類型說明預設
value float64 無預設

Light_GetCurrentRgbValue_Response

定義於 fuchsia.hardware.light/light.fidl

欄位類型說明預設
value Rgb 無預設

Light_GetCurrentSimpleValue_Response

定義於 fuchsia.hardware.light/light.fidl

欄位類型說明預設
value bool 無預設

Light_GetGroupCurrentBrightnessValue_Response

定義於 fuchsia.hardware.light/light.fidl

欄位類型說明預設
values vector<float64>? 無預設

淺色_GetGroupCurrentRgbValue_Response

定義於 fuchsia.hardware.light/light.fidl

欄位類型說明預設
values vector<Rgb>? 無預設

Light_GetGroupCurrentSimpleValue_Response

定義於 fuchsia.hardware.light/light.fidl

欄位類型說明預設
values vector<bool>? 無預設

淺色_GetGroupInfo_回應

定義於 fuchsia.hardware.light/light.fidl

欄位類型說明預設
info GroupInfo 無預設

Light_GetInfo_Response

定義於 fuchsia.hardware.light/light.fidl

欄位類型說明預設
info Info 無預設

光照_設定值_回應

定義於 fuchsia.hardware.light/light.fidl

<空白>

光照_SetGroupBrightnessValue_Response

定義於 fuchsia.hardware.light/light.fidl

<空白>

光源_SetGroupRgbValue_Response

定義於 fuchsia.hardware.light/light.fidl

<空白>

淺色_SetGroupSimpleValue_Response

定義於 fuchsia.hardware.light/light.fidl

<空白>

光源_SetRgbValue_Response

定義於 fuchsia.hardware.light/light.fidl

<空白>

淺色_SetSimpleValue_Response

定義於 fuchsia.hardware.light/light.fidl

<空白>

RGB

定義於 fuchsia.hardware.light/light.fidl

欄位類型說明預設
red float64 無預設
green float64 無預設
blue float64 無預設

表情符號

功能嚴格

類型：uint32

定義於 fuchsia.hardware.light/light.fidl

名稱值說明
1

此能力表示燈具支援將亮度設定為 uint8_t 值。如果不支援這項能力，燈具僅支援關閉和開啟狀態。
2

此能力表示光源支援設定 RGB 值。
3

沒有任何功能

LightError strict

類型：uint32

定義於 fuchsia.hardware.light/light.fidl

名稱值說明
0
1
2
3

聯合國

Light_GetCurrentBrightnessValue_Result strict

定義於 fuchsia.hardware.light/light.fidl

序數Variant類型說明
response Light_GetCurrentBrightnessValue_Response
err LightError

Light_GetCurrentRgbValue_Result 嚴格

定義於 fuchsia.hardware.light/light.fidl

序數Variant類型說明
response Light_GetCurrentRgbValue_Response
err LightError

Light_GetCurrentSimpleValue_Result strict

定義於 fuchsia.hardware.light/light.fidl

序數Variant類型說明
response Light_GetCurrentSimpleValue_Response
err LightError

Light_GetGroupCurrentBrightnessValue_Result strict

定義於 fuchsia.hardware.light/light.fidl

序數Variant類型說明
response Light_GetGroupCurrentBrightnessValue_Response
err LightError

Light_GetGroupCurrentRgbValue_Result 嚴格

定義於 fuchsia.hardware.light/light.fidl

序數Variant類型說明
response Light_GetGroupCurrentRgbValue_Response
err LightError

Light_GetGroupCurrentSimpleValue_Result strict

定義於 fuchsia.hardware.light/light.fidl

序數Variant類型說明
response Light_GetGroupCurrentSimpleValue_Response
err LightError

Light_GetGroupInfo_Result 嚴格

定義於 fuchsia.hardware.light/light.fidl

序數Variant類型說明
response Light_GetGroupInfo_Response
err LightError

Light_GetInfo_Result 嚴格

定義於 fuchsia.hardware.light/light.fidl

序數Variant類型說明
response Light_GetInfo_Response
err LightError

Light_SetBrightnessValue_Result strict

定義於 fuchsia.hardware.light/light.fidl

序數Variant類型說明
response Light_SetBrightnessValue_Response
err LightError

Light_SetGroupBrightnessValue_Result strict

定義於 fuchsia.hardware.light/light.fidl

序數Variant類型說明
response Light_SetGroupBrightnessValue_Response
err LightError

Light_SetGroupRgbValue_Result strict

定義於 fuchsia.hardware.light/light.fidl

序數Variant類型說明
response Light_SetGroupRgbValue_Response
err LightError

Light_SetGroupSimpleValue_Result strict

定義於 fuchsia.hardware.light/light.fidl

序數Variant類型說明
response Light_SetGroupSimpleValue_Response
err LightError

Light_SetRgbValue_Result 嚴格

定義於 fuchsia.hardware.light/light.fidl

序數Variant類型說明
response Light_SetRgbValue_Response
err LightError

Light_SetSimpleValue_Result strict

定義於 fuchsia.hardware.light/light.fidl

序數Variant類型說明
response Light_SetSimpleValue_Response
err LightError

場景

名稱值類型說明
LIGHT_NAME_LEN 32 uint8