Files
XCEngine/docs/api/XCEngine/Scripting/ScriptEngine/DefaultFixedDeltaTime.md

42 lines
1.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)