> ## 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.

# LampArray

> LampArray

# LampArray

LampArray API 允许调用方感知已连接的 RGB 光照外围设备，检查这些设备的属性，并更改相关灯光的颜色和亮度值。

## 接口

| 接口                                                                           | 描述                  |
| ---------------------------------------------------------------------------- | ------------------- |
| [ILampArray](/reference/lighting/lamparray/interfaces/ilamparray/ilamparray) | 表示一个支持光照的设备。        |
| [ILampInfo](/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo)    | 单个可寻址 Lamp 及其属性的表示。 |

## 函数

| 函数                                                                                                                         | 描述                                             |
| -------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| [LampArrayCallback](/reference/lighting/lamparray/functions/lamparraycallback)                                             | 用于 LampArray 连接和断开事件的、由标题定义的回调。                |
| [RegisterLampArrayCallback](/reference/lighting/lamparray/functions/registerlamparraycallback)                             | RegisterLampArrayCallback API 参考               |
| [TrySetLampArrayWorkerThreadAffinityMask](/reference/lighting/lamparray/functions/trysetlamparrayworkerthreadaffinitymask) | TrySetLampArrayWorkerThreadAffinityMask API 参考 |
| [UnregisterLampArrayCallback](/reference/lighting/lamparray/functions/unregisterlamparraycallback)                         | UnregisterLampArrayCallback API 参考             |

## 结构

| 结构                                                                           | 描述                      |
| ---------------------------------------------------------------------------- | ----------------------- |
| [LampArrayColor](/reference/lighting/lamparray/structs/lamparraycolor)       | 用红、绿、蓝和 alpha 通道描述一种颜色。 |
| [LampArrayPosition](/reference/lighting/lamparray/structs/lamparrayposition) | 表示从给定原点在 3D 空间中的度量。     |

## 枚举

| 枚举                                                                    | 描述                          |
| --------------------------------------------------------------------- | --------------------------- |
| [LampArrayKind 枚举](/reference/lighting/lamparray/enums/lamparraykind) | 描述此 ILampArray 所属物理设备的常规类型。 |
| [LampPurposes 枚举](/reference/lighting/lamparray/enums/lamppurposes)   | 描述单个 Lamp 预期用于的一组用途。        |


## Related topics

- [LampArray 效果](/zh-CN/build/core-features/common/lighting/lighting-effects.md)
- [ILampArray](/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)
- [LampArrayCallback](/zh-CN/reference/lighting/lamparray/functions/lamparraycallback.md)
- [LampArrayColor](/zh-CN/reference/lighting/lamparray/structs/lamparraycolor.md)
- [LampArrayPosition](/zh-CN/reference/lighting/lamparray/structs/lamparrayposition.md)