# ScriptEngine::DefaultFixedDeltaTime

**命名空间**: `XCEngine::Scripting`

**类型**: `constant`

**头文件**: `XCEngine/Scripting/ScriptEngine.h`

## 定义

```cpp
static constexpr float DefaultFixedDeltaTime = 1.0f / 50.0f;
```

## 当前语义

这是 `ScriptEngine` 的默认运行时固定步长配置，当前值等于 `0.02f`，也就是 `50 Hz`。

它会在以下场景被使用：

- `ScriptEngine` 初始构造时，`m_runtimeFixedDeltaTime` 用它初始化
- [SetRuntimeFixedDeltaTime](SetRuntimeFixedDeltaTime.md) 传入非正值时回退到该值
- [OnRuntimeStop](OnRuntimeStop.md) 清理运行态后把当前配置重置为该值

## 设计含义

它不是 `SceneRuntime` 的强制固定帧率控制器，而是 `ScriptEngine` 暴露给原生和托管脚本的“默认 fixed delta 配置值”。

当前具体某次 fixed tick 仍由上层调用 [OnFixedUpdate](OnFixedUpdate.md) 时传入的参数决定。

这和商业引擎里的固定步长设置很像：它更接近“推荐配置值”或“当前运行态默认值”，而不是单独一个能自动驱动物理循环的时钟。

## 托管侧可见性

当运行时没有显式配置过新的 fixed delta，托管 `Time.fixedDeltaTime` 最终读到的也是这份默认值。

## 相关文档

- [SetRuntimeFixedDeltaTime](SetRuntimeFixedDeltaTime.md)
- [GetRuntimeFixedDeltaTime](GetRuntimeFixedDeltaTime.md)
- [OnRuntimeStop](OnRuntimeStop.md)