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

# ILampArray::SetBrightnessLevel 方法

> 設定套用至 LampArray 上每個 Lamp 的整體亮度比例，其中 0.0 為完全關閉，1.0 為最大亮度。

# 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 概觀](/zh-TW/build/core-features/common/lighting/gc-lighting-toc)\
[ILampArray::GetBrightnessLevel](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getbrightnesslevel)\
[ILampArray](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/ilamparray)


## Related topics

- [ILampArray::GetBrightnessLevel 方法](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getbrightnesslevel.md)
- [ILampArray::SetColor 方法](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolor.md)
- [ILampArray::SetIsEnabled 方法](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setisenabled.md)
- [ILampArray::SetColorsForIndices 方法](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices.md)
- [ILampArray::SetColorsForScanCodes 方法](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforscancodes.md)