跳轉到主要內容
在單一更新中將所有暫存的燈光色彩傳送至輸入裝置。

語法

參數

此方法沒有參數。

傳回值

類型:void

備註

您透過呼叫 IGameInputDevice::SetLightingColor 所設定的色彩只會被暫存;在您呼叫 ApplyLightingColors 之前,燈不會改變。此方法會在單次寫入中將每盞燈的暫存色彩傳送至裝置,因此對多個群組或多盞燈的變更會同時生效。 只有具有暫存色彩的燈會更新。如果沒有暫存任何色彩,呼叫不會有任何作用。 暫存色彩在套用後仍會持續生效。若之後要變更某個群組,請為該群組暫存新色彩,然後再次呼叫 ApplyLightingColors;其他燈的色彩會保留。若要捨棄所有暫存色彩並讓燈恢復預設行為,請呼叫 IGameInputDevice::ApplyLightingSystemDefault。 當裝置中斷連線時,其暫存色彩會被捨棄。對已中斷連線之裝置的呼叫不會有任何作用。 下列範例會將控制器的正面按鈕設定為紅色、將其中央燈設定為藍色,然後在單一更新中套用這兩種色彩。
燈光支援取決於裝置和平台。目前,GameInput 支援 Windows 動態燈光 (LampArray) 裝置以及 DualSense 控制器燈條上的燈光。

需求

標頭: GameInput.h 程式庫: gameinput.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

GameInput 概觀
IGameInputDevice
IGameInputDevice::SetLightingColor
IGameInputDevice::ApplyLightingSystemDefault
IGameInputDevice::GetSupportedLightingGroups
GameInputColor
GameInputLightingGroups

版本歷程記錄

最後修改於 2026年11月6日