Pular para o conteúdo principal
Envia todas as cores de iluminação preparadas para o dispositivo de entrada em uma única atualização.

Sintaxe

Parâmetros

Este método não tem parâmetros.

Valor retornado

Tipo: void

Comentários

As cores que você define chamando IGameInputDevice::SetLightingColor são apenas preparadas; elas não alteram as lâmpadas até que você chame ApplyLightingColors. Este método envia as cores preparadas de todas as lâmpadas ao dispositivo em uma única gravação, de modo que as alterações em vários grupos ou lâmpadas entrem em vigor ao mesmo tempo. Somente as lâmpadas que têm uma cor preparada são atualizadas. Se nenhuma cor estiver preparada, a chamada não terá efeito. As cores preparadas permanecem em vigor depois de aplicadas. Para alterar um grupo posteriormente, prepare a nova cor para esse grupo e chame ApplyLightingColors novamente; as cores das outras lâmpadas são preservadas. Para descartar todas as cores preparadas e retornar as lâmpadas ao comportamento padrão, chame IGameInputDevice::ApplyLightingSystemDefault. Quando o dispositivo é desconectado, as cores preparadas dele são descartadas. Chamadas em um dispositivo desconectado não têm efeito. O exemplo a seguir define os botões frontais de um controle como vermelhos e a luz central como azul e, em seguida, aplica as duas cores em uma única atualização.
O suporte à iluminação depende do dispositivo e da plataforma. Atualmente, o GameInput oferece suporte à iluminação em dispositivos com Iluminação Dinâmica do Windows (LampArray) e na barra de luz dos controles DualSense.

Requisitos

Cabeçalho: GameInput.h Biblioteca: gameinput.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Confira também

Visão geral do GameInput
IGameInputDevice
IGameInputDevice::SetLightingColor
IGameInputDevice::ApplyLightingSystemDefault
IGameInputDevice::GetSupportedLightingGroups
GameInputColor
GameInputLightingGroups

Histórico de versões

Última modificação em 6 de novembro de 2026