GFInputHoldTrigger

API Reference / Standard / 类索引

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

长按触发器。 输入持续活跃达到 hold_seconds 后，动作才进入活跃状态。释放输入会重置计时。

成员概览

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

属性

hold_seconds

• API：public

var hold_seconds: float = 0.25:

需要持续按住的秒数。

方法

reset_trigger_state

• API：public

func reset_trigger_state(state: Dictionary) -> void:

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

参数：

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

结构：

• state: Dictionary，由输入运行时持有，包含 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，由输入运行时持有，包含 elapsed: float。