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

[在 LampArray 上设置颜色](https://docs.xbox.com/zh-CN/build/core-features/common/lighting/lighting-colors.md)
介绍如何使用 LampArray API 执行基本的颜色操作。

[LampArray 效果](https://docs.xbox.com/zh-CN/build/core-features/common/lighting/lighting-effects.md)
提供有关创建更复杂 LampArray 光照效果的技巧。

## 另请参阅

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

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


## Related topics

- [概述](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/overviews/index.md)
- [光照 API 参考（API 内容）](https://docs.xbox.com/zh-CN/reference/lighting/gc-reference-lighting-toc.md)
- [Xfest2019](https://docs.xbox.com/zh-CN/build/core-features/graphics/overviews/presentations/xfest2019/index.md)
- [ILampArray（接口内容）](https://docs.xbox.com/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)
- [ILampInfo（接口内容）](https://docs.xbox.com/zh-CN/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo.md)