语法
参数
color类型:GameInputColor 要为所选灯暂存的颜色。 group
类型:GameInputLightingGroups 包含要设置的灯的灯光组选择。可以是一个或多个命名组标志、用于选择设备上每个灯的
GameInputLightingGroupAll,或用于选择不属于任何命名组的灯的 GameInputLightingGroupUnknown。
groupOrderIndex _In_opt_类型:uint32_t 选择 group 中的单个灯。默认值
GAMEINPUT_LIGHTING_GROUP_ORDER_INDEX_ALL 选择 group 中的每个灯。有关其他值的解释方式,请参阅“备注”。
返回值
类型:void备注
SetLightingColor 不会立即更改灯的状态。它会为所选灯记录(暂存)颜色。调用 IGameInputDevice::ApplyLightingColors 可通过一次更新将所有暂存的颜色发送到设备。由于在应用颜色之前不会发送任何内容,因此你可以设置多个组或多个单独的灯,并让它们同时发生变化。暂存的颜色在应用后仍然有效,因此若要稍后更改某个组,只需为该组暂存新颜色并再次应用即可。
groupOrderIndex 参数按如下方式解释。
将
GameInputLightingGroupKeyboardKey 与其他命名组组合的选择无法选择单个灯,因为索引会产生歧义。对于此类选择,请使用 GAMEINPUT_LIGHTING_GROUP_ORDER_INDEX_ALL。GameInputLightingGroupAll 可以按单个灯在设备所有灯中的从零开始的位置来选择该灯。
如果所选范围对设备无效,则该调用会被忽略,并且不会暂存任何内容。如果所选范围包含设备不具有的命名组(请参阅 IGameInputDevice::GetSupportedLightingGroups)、不包含任何灯,或者指定的 groupOrderIndex 超出范围或不是有效的扫描码,则该所选范围无效。对已断开连接的设备进行的调用不起作用。
若要丢弃暂存的颜色并让灯恢复默认行为,请调用 IGameInputDevice::ApplyLightingSystemDefault。
以下示例将控制器的正面按钮设置为红色、将中央灯设置为蓝色,然后通过一次更新应用这两种颜色。
灯光支持取决于设备和平台。目前,GameInput 支持 Windows 动态光效 (LampArray) 设备以及 DualSense 控制器灯条的灯光。
要求
头文件: GameInput.h 库: gameinput.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机另请参阅
GameInput 概述IGameInputDevice
GameInputColor
GameInputLightingGroups
IGameInputDevice::ApplyLightingColors
IGameInputDevice::ApplyLightingSystemDefault
IGameInputDevice::GetSupportedLightingGroups
IGameInputDevice::GetSupportedLightingGroupSize
