Sintaxis
Parámetros
Este método no tiene parámetros.Valor devuelto
Tipo: GameInputLightingGroups Una combinación de marcas deGameInputLightingGroups para cada grupo de iluminación con nombre que contiene al menos una lámpara del dispositivo. Devuelve GameInputLightingGroupUnknown (0) si el dispositivo no tiene lámparas en ningún grupo con nombre.
Comentarios
Cada marca del valor devuelto identifica un grupo de lámparas con nombre, comoGameInputLightingGroupFaceButtons o GameInputLightingGroupCenterLight, al que puede dirigirse con IGameInputDevice::SetLightingColor. El método nunca notifica GameInputLightingGroupUnknown como grupo, porque su valor es 0.
Un dispositivo puede tener lámparas que no pertenecen a ningún grupo con nombre. Por lo tanto, un valor devuelto de 0 no siempre significa que el dispositivo no tenga lámparas. Para determinar si un dispositivo admite la iluminación, compruebe si IGameInputDevice::GetSupportedInput incluye GameInputKindLighting, o llame a IGameInputDevice::GetSupportedLightingGroupSize con GameInputLightingGroupAll. Para contar las lámparas que no están en un grupo con nombre, llame a GetSupportedLightingGroupSize con GameInputLightingGroupUnknown.
En el siguiente ejemplo se establecen en rojo los botones frontales y en azul la luz central en los dispositivos que tienen esos grupos, y luego se aplican los colores en una sola actualización.
La compatibilidad con la iluminación depende del dispositivo y de la plataforma. Actualmente, GameInput admite la iluminación en dispositivos con Iluminación dinámica de Windows (LampArray) y en la barra de luz de los mandos DualSense.
Requisitos
Encabezado: GameInput.h Biblioteca: gameinput.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX SeriesConsulte también
Información general de GameInputIGameInputDevice
GameInputLightingGroups
IGameInputDevice::GetSupportedLightingGroupSize
IGameInputDevice::SetLightingColor
IGameInputDevice::ApplyLightingColors
IGameInputDevice::ApplyLightingSystemDefault
