docs: sync api and planning docs

This commit is contained in:
2026-04-08 16:07:03 +08:00
parent 08c3278e10
commit 31756847ab
1826 changed files with 44502 additions and 29645 deletions

View File

@@ -0,0 +1,41 @@
# 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)