語法
參數
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
