GFHapticPreset¶
API Reference / Feedback / 类索引
- 路径：
addons/gf/extensions/feedback/resources/gf_haptic_preset.gd - 模块：
Feedback - 继承：
Resource - API：
public - 类别：资源定义 (
resource_definition) - 首次版本：
7.0.0
通用手柄震动采样预设。 描述一段弱/强马达强度曲线，不绑定命中、相机、角色、UI 或具体玩法事件。
成员概览¶
| 类型 | 名称 | 签名 |
|---|---|---|
| 属性 | duration_seconds |
var duration_seconds: float = 0.25 |
| 属性 | weak_magnitude |
var weak_magnitude: float = 0.5 |
| 属性 | strong_magnitude |
var strong_magnitude: float = 0.5 |
| 属性 | intensity |
var intensity: float = 1.0 |
| 属性 | weak_curve |
var weak_curve: Curve = null |
| 属性 | strong_curve |
var strong_curve: Curve = null |
| 方法 | get_duration_seconds |
func get_duration_seconds() -> float: |
| 方法 | sample |
func sample(elapsed_seconds: float, strength: float = 1.0) -> Dictionary: |
| 方法 | sample_at_progress |
func sample_at_progress(progress: float, strength: float = 1.0) -> Dictionary: |
| 方法 | zero_sample |
static func zero_sample() -> Dictionary: |
| 方法 | combine_samples |
static func combine_samples(samples: Array[Dictionary]) -> Dictionary: |
属性¶
duration_seconds¶
- API：
public - 首次版本：
7.0.0
持续时间，单位秒。
weak_magnitude¶
- API：
public - 首次版本：
7.0.0
低频马达基础强度，范围 0 到 1。
strong_magnitude¶
- API：
public - 首次版本：
7.0.0
高频马达基础强度，范围 0 到 1。
intensity¶
- API：
public - 首次版本：
7.0.0
预设整体强度倍率。
weak_curve¶
- API：
public - 首次版本：
7.0.0
低频马达强度曲线。为空时使用恒定 1.0。
strong_curve¶
- API：
public - 首次版本：
7.0.0
高频马达强度曲线。为空时使用恒定 1.0。
方法¶
get_duration_seconds¶
- API：
public - 首次版本：
7.0.0
获取有效持续时间。
返回：持续时间，最小为 0。
sample¶
- API：
public - 首次版本：
7.0.0
按时间采样震动强度。
参数：
| 名称 | 说明 |
|---|---|
elapsed_seconds |
已经过的秒数。 |
strength |
本次播放强度倍率。 |
返回：震动采样结果。
结构：
return: Dictionary，包含 weak_magnitude、strong_magnitude、intensity 与 progress。
sample_at_progress¶
- API：
public - 首次版本：
7.0.0
按归一化进度采样震动强度。
参数：
| 名称 | 说明 |
|---|---|
progress |
归一化进度，范围 0 到 1。 |
strength |
本次播放强度倍率。 |
返回：震动采样结果。
结构：
return: Dictionary，包含 weak_magnitude、strong_magnitude、intensity 与 progress。
zero_sample¶
- API：
public - 首次版本：
7.0.0
创建空震动采样结果。
返回：空震动采样结果。
结构：
return: Dictionary，包含零值 weak_magnitude、strong_magnitude、intensity 与 progress。
combine_samples¶
- API：
public - 首次版本：
7.0.0
合并多个震动采样。
参数：
| 名称 | 说明 |
|---|---|
samples |
震动采样数组。 |
返回：合并后的震动采样。
结构：
samples: Array[Dictionary]，每项包含 weak_magnitude、strong_magnitude、intensity 与 progress。return: Dictionary，包含合并后的 weak_magnitude、strong_magnitude、intensity 与 progress。