> ## 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 上设置颜色 ILampArray 上所有的颜色更新函数都使用 [LampArrayColor](/reference/lighting/lamparray/structs/lamparraycolor) 结构来表示 RGBA 颜色值。 alpha 值 (LampArrayColor::a) 表示颜色的相对透明度，其中零表示完全透明，0xFF 表示完全不透明。如果使用的 alpha 值不是 0xFF，颜色将会与黑色进行额外的混合步骤。为了避免这一混合步骤，设置颜色时请勿传入除 0xFF 以外的 alpha 值。 为获得最佳性能与 Lamp 状态一致性，ILampArray 的 SetColor API 设计为从单个线程调用。 ## 更新所有 Lamp [ILampArray::SetColor](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolor) 方法将设备上所有 Lamp 的颜色更改为所需颜色。 以下示例注册一个 LampArray 回调，并设置每个连接设备的颜色。 ```cpp theme={null} const LampArrayColor greenColor = { 0x0 /* r */, 0xFF /* g */, 0x0 /* b */, 0xFF /* a */}; std::vector> lampArrays; void MyLampArrayStatusCallback( _In_opt_ void* context, LampArrayStatus currentStatus, LampArrayStatus previousStatus, _In_ ILampArray* lampArray) { const bool wasAttached = (previousStatus & LampArrayStatus::Connected) == LampArrayStatus::Connected; const bool isAttached = (currentStatus & LampArrayStatus::Connected) == LampArrayStatus::Connected; if (wasAttached != isAttached) { if (isAttached) { lampArray->SetColor(greenColor); lampArrays.push_back(lampArray); } else { for (auto iter = lampArrays.begin(); iter != lampArrays.end(); ) { if (iter->Get() == lampArray) { lampArrays.erase(iter); } else { iter++; } } } } } void MainLoop( _In_ volatile bool & cancelMonitoring) noexcept { LampArrayCallbackToken token = LAMPARRAY_INVALID_CALLBACK_TOKEN_VALUE; if (SUCCEEDED(RegisterLampArrayStatusCallback( MyLampArrayStatusCallback, LampArrayEnumerationKind::Async, nullptr /* context */, &token))) { while (!cancelMonitoring) { Sleep(100); } UnregisterLampArrayCallback(token, 5000); } } ``` ## 定位单个 Lamp 或 Lamp 组 [ILampArray::SetColorsForIndices](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices) 用于更新 LampArray 中的一个或多个 Lamp。传入此 API 的 Lamp 索引可以是任意顺序。 以下示例说明了如何在 LampArray 的所有 Lamp 上设置交替颜色。 ```cpp theme={null} void SetAlternatingColors(ILampArray* lampArray) { const LampArrayColor blueColor = { 0x0 /* r */, 0x0 /* g */, 0xFF /* b */, 0xFF /* a */}; const LampArrayColor redColor = { 0xFF /* r */, 0x0 /* g */, 0x0 /* b */, 0xFF /* a */}; const uint32_t lampCount = lampArray->GetLampCount(); // Set up our index and color buffers std::vector indicesBuffer(lampCount); std::vector colorsBuffer(lampCount); // Populate the buffers for (uint32_t i = 0; i < lampCount; i++) { // We will use all the Lamps for this update. indicesBuffer[i] = i; // Odd numbered indices will be red, even numbered indices will be blue if (i % 2 != 0) { colorsBuffer[i] = redColor; } else { colorsBuffer[i] = blueColor; } } // Apply the colors to the LampArray lampArray->SetColorsForIndices(lampCount, indicesBuffer.data(), colorsBuffer.data()); } ``` 以下示例展示如何为 LampArray 上的单个 Lamp 或 Lamp 组更新颜色。 ```cpp theme={null} void MyCustomColorUpdate(ILampArray* lampArray) { const LampArrayColor greenColor = { 0x0 /* r */, 0xFF /* g */, 0x0 /* b */, 0xFF /* a */}; const LampArrayColor yellowColor = { 0xFF /* r */, 0xFF /* g */, 0x0 /* b */, 0xFF /* a */}; const LampArrayColor whiteColor = { 0xFF /* r */, 0xFF /* g */, 0xFF /* b */, 0xFF /* a */}; const uint32_t lampCount = lampArray->GetLampCount(); // Set custom colors for a single lamp at index 4 const uint32_t index = 4; lampArray->SetColorsForIndices(1, &index, &greenColor); // Simultaneously make Lamp 1 yellow and Lamp 3 white std::vector indicesBuffer = { 1, 3 }; std::vector colorsBuffer = { yellowColor, whiteColor }; // Apply the colors to the LampArray lampArray->SetColorsForIndices(static_cast(indicesBuffer.size()), indicesBuffer.data(), colorsBuffer.data()); } ``` ## 使用键盘扫描代码定位 Lamp [ILampArray::SetColorsForScanCodes](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforscancodes) 提供了一种便捷的方法，用于设置 LampArray 键盘上特定按键的 Lamp 颜色。这可以用于在教程环境中帮助用户了解需要按哪些键，或在键盘上显示与游戏状态相关的信息。 以下示例说明了如何更改 LampArray 键盘上 WASD 键的 Lamp 颜色： ```cpp theme={null} #define SC_W 0x11 #define SC_A 0x1E #define SC_S 0x1F #define SC_D 0x20 void UpdateWASDKeys(ILampArray* lampArray) { const LampArrayColor blueColor = { 0x0 /* r */, 0x0 /* g */, 0xFF /* b */, 0xFF /* a */}; const LampArrayColor yellowColor = { 0xFF /* r */, 0xFF /* g */, 0x0 /* b */, 0xFF /* a */}; // Set the color for all lamps. We will override the WASD keys below. lampArray->SetColor(blueColor); // Set up the buffer of scan codes for the Lamps we want to target std::vector scanCodesBuffer = { SC_W, SC_A, SC_S, SC_D }; // Create a matching buffer of LampArrayColors. In this example, we will set all of the WASD keys to yellow. std::vector colorsBuffer; for (size_t i = 0; i < scanCodesBuffer.size(); i++) { colorsBuffer.push_back(yellowColor); } // Set the color for the WASD keys lampArray->SetColorsForScanCodes(static_cast(scanCodesBuffer.size()), scanCodesBuffer.data(), colorsBuffer.data()); } ``` ## 另请参阅 [光照 API 概览](/build/core-features/common/lighting/gc-lighting-toc) [ILampArray 参考](/reference/lighting/lamparray/interfaces/ilamparray/ilamparray) [LampArrayColor](/reference/lighting/lamparray/structs/lamparraycolor) [ILampArray::SetColor](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolor) [ILampArray::SetColorsForIndices](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices) [ILampArray::SetColorsForScanCodes](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforscancodes) ## Related topics - [LampArrayColor](/zh-CN/reference/lighting/lamparray/structs/lamparraycolor.md) - [ILampArray::SetColor](/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolor.md) - [ILampArray::SetColorsForIndices](/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices.md) - [ILampArray::SetColorsForScanCodes](/zh-CN/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforscancodes.md) - [光照 API 概览](/zh-CN/build/core-features/common/lighting/gc-lighting-toc.md)