> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 照明概觀

> 照明 API 概觀

## 簡介

Microsoft Game Development Kit (GDK) 提供輕量型 API，可控制各種周邊裝置 (包括鍵盤、滑鼠、耳機等) 上的 RGB 照明。

相容的裝置會實作或適應 [HID 照明與發光標準](https://www.usb.org/sites/default/files/hutrr84_-_lighting_and_illumination_page.pdf)。在此規格中：

* *Lamp* 是單一 LED、燈泡或其他光源，可以操作其開啟/關閉狀態、亮度及/或 RGB 色彩值。

* 包含一或多個 Lamp 且符合上述 HID 照明標準的裝置稱為 *LampArray*。

GDK 中包含的照明 API 也使用 LampArray 這個名稱。

> **請注意：** 截至 2023 年 3 月復原版本，GDK 照明 API 在主機上僅支援下列裝置。未來的復原版本將會新增對其他裝置的支援。
>
> * Razer Turret for XBOX One (鍵盤和滑鼠)
> * Razer BlackWidow Tournament Edition Chroma V2

## 主題

[LampArray 基本概念](https://docs.xbox.com/zh-TW/build/core-features/common/lighting/lighting-basics.md)
說明如何取得和檢查構成 LampArray API 的基本物件。

[在 LampArray 上設定色彩](https://docs.xbox.com/zh-TW/build/core-features/common/lighting/lighting-colors.md)
說明如何使用 LampArray API 執行基本色彩作業。

[LampArray 效果](https://docs.xbox.com/zh-TW/build/core-features/common/lighting/lighting-effects.md)
提供建立更複雜 LampArray 照明效果的秘訣。

## 另請參閱

[LampArray API 參考](https://docs.xbox.com/zh-TW/reference/lighting/gc-reference-lighting-toc.md)

[Microsoft Game Development Kit](https://docs.xbox.com/zh-TW/services/playfab/sdks/platforms/gdk.md)


## Related topics

- [照明 API 參考 (API 內容)](https://docs.xbox.com/zh-TW/reference/lighting/gc-reference-lighting-toc.md)
- [XBOX Game Publisher Insights 常見問題集](https://docs.xbox.com/zh-TW/publishing/game-publishing/concepts/game-publisher-insights/game-publisher-insights-faq.md)
- [ILampArray (介面內容)](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)
- [ILampInfo (介面內容)](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo.md)
- [RegisterLampArrayCallback](https://docs.xbox.com/zh-TW/reference/lighting/lamparray/functions/registerlamparraycallback.md)