GFInputPulseTrigger

API Reference / Standard / 类索引

• 路径：addons/gf/standard/input/triggers/gf_input_pulse_trigger.gd
• 模块：Standard
• 继承：GFInputTrigger
• API：public
• 类别：资源定义 (resource_definition)
• 首次版本：3.17.0

周期脉冲触发器。 输入持续活跃时按固定间隔触发一次，可用于连发、菜单重复导航等通用场景。

成员概览

类型	名称	签名
属性	interval_seconds	var interval_seconds: float = 0.1:
属性	trigger_immediately	var trigger_immediately: bool = true
方法	reset_trigger_state	func reset_trigger_state(state: Dictionary) -> void:
方法	update	func update(raw_active: bool, _value: Variant, delta: float, state: Dictionary) -> TriggerState:

属性

interval_seconds

• API：public

var interval_seconds: float = 0.1:

脉冲间隔秒数。

trigger_immediately

• API：public

var trigger_immediately: bool = true

输入首次变为活跃时是否立即触发。

方法

reset_trigger_state

• API：public

func reset_trigger_state(state: Dictionary) -> void:

重置输入触发器运行时状态。

参数：

名称	说明
state	触发器运行时状态字典。

结构：

• state: Dictionary，由输入运行时持有，包含 was_active: bool 和 elapsed: float。

update

• API：public

func update(raw_active: bool, _value: Variant, delta: float, state: Dictionary) -> TriggerState:

更新运行时状态。

参数：

名称	说明
raw_active	原始输入是否处于激活状态。
_value	输入值，默认实现不直接使用。
delta	本帧时间增量（秒）。
state	触发器运行时状态字典。

返回：触发状态。

结构：

• _value: Variant，由当前输入映射产生的动作值。
• state: Dictionary，由输入运行时持有，包含 was_active: bool 和 elapsed: float。