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

# Lighting API 참조 (API 콘텐츠)

> Lighting API 참고 자료

# Lighting API 참고 자료

Microsoft Game Development Kit(GDK)의 Lighting API 참고 자료입니다. 이러한 API를 사용하여 호환되는 LampArray 주변 장치(키보드, 마우스, 헤드셋 및 기타 HID 조명 장치)를 열거하고 해당 장치의 RGB 조명을 제어할 수 있습니다.

## 호환되는 주변 장치 열거

호환되는 주변 장치를 검색하려면, 각 연결된 장치에 대해 그리고 장치가 연결되거나 제거될 때마다 LampArray API가 호출하는 상태 콜백을 등록합니다.

1. 장치의 연결 및 연결 해제 이벤트를 수신할 [LampArrayStatusCallback](https://docs.xbox.com/ko/reference/lighting/lamparray/functions/lamparraystatuscallback.md) 함수를 구현합니다.
2. [RegisterLampArrayStatusCallback](https://docs.xbox.com/ko/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)을 호출하여 콜백을 등록합니다. 초기 열거를 비동기로 실행할지 아니면 연결된 모든 장치를 보고할 때까지 블록할지를 제어하려면 [LampArrayEnumerationKind](https://docs.xbox.com/ko/reference/lighting/lamparray/enums/lamparrayenumerationkind.md) 값을 전달합니다.
3. 콜백에서 [ILampArray](https://docs.xbox.com/ko/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md) 인스턴스를 검사하여 [DeviceId](https://docs.xbox.com/ko/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getdeviceid.md), [LampArrayKind](https://docs.xbox.com/ko/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlamparraykind.md), [LampCount](https://docs.xbox.com/ko/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlampcount.md), [VendorId](https://docs.xbox.com/ko/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getvendorid.md), [ProductId](https://docs.xbox.com/ko/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getproductid.md)와 같은 장치 속성을 읽습니다.
4. 알림이 더 이상 필요하지 않으면 [UnregisterLampArrayStatusCallback](https://docs.xbox.com/ko/reference/lighting/lamparray/functions/unregisterlamparraycallback.md)을 호출하여 이벤트 수신을 중지합니다.

샘플 코드와 함께 자세한 안내를 보려면 [LampArray 기본 사항](https://docs.xbox.com/ko/build/core-features/common/lighting/lighting-basics.md)을 참조하세요.

## 이 섹션의 내용

[LampArray](https://docs.xbox.com/ko/reference/lighting/lamparray/lamparray_members.md)\
LampArray API 멤버로, 장치를 열거하고 조명을 제어하는 데 사용되는 함수, 인터페이스, 열거형 및 구조체를 포함합니다.

## 함께 보기

[Lighting API 개요](https://docs.xbox.com/ko/build/core-features/common/lighting/gc-lighting-toc.md)


## Related topics

- [API 참조(콘텐츠)](https://docs.xbox.com/ko/reference/gc-reference-toc.md)
- [Chat API 참조(콘텐츠)](https://docs.xbox.com/ko/reference/chat/gc-reference-chat-toc.md)
- [HttpClient API 참조 (콘텐츠)](https://docs.xbox.com/ko/reference/live/httpclient/atoc-httpclient.md)
- [XGameSave Wrapper 참조 (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/Wrappers/xgamesave_wrapper_members.md)
- [XPackage (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xpackage/xpackage_members.md)