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

# 光照 API 概览

> 光照 API 概览

<a id="introductionSection" />

## 简介

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 基础](/build/core-features/common/lighting/lighting-basics)
介绍如何获取和检查组成 LampArray API 的基础对象。

[在 LampArray 上设置颜色](/build/core-features/common/lighting/lighting-colors)
介绍如何使用 LampArray API 执行基本的颜色操作。

[LampArray 效果](/build/core-features/common/lighting/lighting-effects)
提供有关创建更复杂 LampArray 光照效果的技巧。

<a id="seeAlsoSection" />

## 另请参阅

[LampArray API 参考](/reference/lighting/gc-reference-lighting-toc)

[Microsoft Game Development Kit](/services/playfab/sdks/platforms/gdk)


## Related topics

- [光照 API 参考](/zh-CN/reference/lighting/gc-reference-lighting-toc.md)
- [ILampInfo](/zh-CN/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo.md)
- [ILampArray](/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)
- [RegisterLampArrayCallback](/zh-CN/reference/lighting/lamparray/functions/registerlamparraycallback.md)
- [UnregisterLampArrayCallback](/zh-CN/reference/lighting/lamparray/functions/unregisterlamparraycallback.md)