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

# SetBrightnessLevel

> ILampArray::SetBrightnessLevel

# ILampArray::SetBrightnessLevel

设置 ILampArray 的整体亮度，其中 0.0 表示完全关闭，1.0 表示最大亮度。

此亮度级别将应用于整个设备。每个 Lamp 都将按亮度值进行等比例缩放。

## 语法

```cpp theme={null}
void SetBrightnessLevel(
    double brightnessLevel)
```

### 参数

*brightnessLevel*\
类型：double

要设置的目标亮度级别。

### 返回值

类型：void

## 备注

超出支持的亮度范围（0.0 到 1.0，含）的参数值将被限制在该范围内。

## 要求

**头文件：** LampArray.h

**库：** xgameplatform.lib

**支持的平台：** XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[光照 API 概览](https://docs.xbox.com/zh-CN/build/core-features/common/lighting/gc-lighting-toc.md)\
[ILampArray::GetBrightnessLevel](https://docs.xbox.com/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getbrightnesslevel.md)\
[ILampArray](https://docs.xbox.com/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)


## Related topics

- [GetBrightnessLevel](https://docs.xbox.com/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getbrightnesslevel.md)
- [ILampArray（接口内容）](https://docs.xbox.com/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)
- [HCSettingsSetTraceLevel](https://docs.xbox.com/zh-CN/reference/live/httpclient/trace/functions/hcsettingssettracelevel.md)
- [HCSettingsGetTraceLevel](https://docs.xbox.com/zh-CN/reference/live/httpclient/trace/functions/hcsettingsgettracelevel.md)
- [Set Performance](https://docs.xbox.com/api-reference/analytics/set-performance.md)