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

# IGameInputDevice::ApplyLightingColors

> 스테이징된 모든 조명 색을 단일 업데이트로 입력 장치에 전송합니다.

스테이징된 모든 조명 색을 단일 업데이트로 입력 장치에 전송합니다.

## 구문

```cpp theme={null}
void ApplyLightingColors();
```

### 매개변수

이 메서드에는 매개변수가 없습니다.

### 반환값

형식: void

## 설명

[IGameInputDevice::SetLightingColor](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md)를 호출하여 설정한 색은 스테이징만 되며, `ApplyLightingColors`를 호출할 때까지 램프가 변경되지 않습니다. 이 메서드는 모든 램프의 스테이징된 색을 한 번의 쓰기로 장치에 전송하므로, 여러 그룹 또는 램프에 대한 변경 사항이 동시에 적용됩니다.

스테이징된 색이 있는 램프만 업데이트됩니다. 스테이징된 색이 없으면 호출해도 아무런 효과가 없습니다.

스테이징된 색은 적용된 후에도 계속 유효합니다. 나중에 한 그룹을 변경하려면 해당 그룹의 새 색을 스테이징하고 `ApplyLightingColors`를 다시 호출하세요. 다른 램프의 색은 유지됩니다. 스테이징된 모든 색을 삭제하고 램프를 기본 동작으로 되돌리려면 [IGameInputDevice::ApplyLightingSystemDefault](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingsystemdefault.md)를 호출하세요.

장치 연결이 끊어지면 스테이징된 색은 삭제됩니다. 연결이 끊어진 장치에 대한 호출은 아무런 효과가 없습니다.

다음 예제는 컨트롤러의 페이스 버튼을 빨간색으로, 중앙 조명을 파란색으로 설정한 다음 두 색을 단일 업데이트로 적용합니다.

```cpp theme={null}
void SetControllerLighting(IGameInputDevice* device) noexcept
{
    const GameInputLightingGroups groups = device->GetSupportedLightingGroups();

    if ((groups & GameInputLightingGroupFaceButtons) != 0)
    {
        device->SetLightingColor({ 255, 0, 0 }, GameInputLightingGroupFaceButtons);
    }

    if ((groups & GameInputLightingGroupCenterLight) != 0)
    {
        device->SetLightingColor({ 0, 0, 255 }, GameInputLightingGroupCenterLight);
    }

    device->ApplyLightingColors();
}
```

> [!NOTE]
>
> 조명 지원은 장치와 플랫폼에 따라 다릅니다. 현재 GameInput은 Windows 동적 조명(LampArray) 장치와 DualSense 컨트롤러의 라이트바에서 조명을 지원합니다.

## 요구 사항

**헤더:** GameInput.h

**라이브러리:** gameinput.lib

**지원되는 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

[GameInput 개요](https://docs.xbox.com/ko/build/core-features/common/input/overviews/input-overview.md)\
[IGameInputDevice](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)\
[IGameInputDevice::SetLightingColor](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md)\
[IGameInputDevice::ApplyLightingSystemDefault](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingsystemdefault.md)\
[IGameInputDevice::GetSupportedLightingGroups](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroups.md)\
[GameInputColor](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/structs/gameinputcolor)\
[GameInputLightingGroups](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputlightinggroups)

## 버전 기록

| 버전 | 변경 사항 |
| - | - |
| **v4** | 도입됨. |


## Related topics

- [IGameInputDevice::SetLightingColor](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md)
- [IGameInputDevice::ApplyLightingSystemDefault](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingsystemdefault.md)
- [IGameInputDevice::GetSupportedLightingGroups](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroups.md)
- [IGameInputDevice::GetSupportedLightingGroupSize](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroupsize.md)
- [하나의 애플리케이션에서 여러 GameInput API 버전 사용](https://docs.xbox.com/ko/build/core-features/common/input/overviews/input-version-interop.md)