XCEngine/docs/api/XCEngine/Debug/Profiler/BeginFrame.md

# Profiler::BeginFrame

标记一帧 profiling 周期的开始。

```cpp
void BeginFrame();
```

## 行为说明

当前实现只记录当前微秒时间到内部 `m_frameStartTime`，不会创建样本，也不会清空已有数据。

这说明它目前更像是为后续“按帧汇总”能力预留入口，而不是已经完整实现的帧级 profiler 边界。

## 参数

- 无。

## 返回值

- 无。

## 线程语义

- 无同步保护；建议在主线程或统一的 profiling 线程中调用。

## 示例

```cpp
auto& profiler = XCEngine::Debug::Profiler::Get();
profiler.BeginFrame();
```

## 相关文档

- [返回类型总览](Profiler.md)
- [EndFrame](EndFrame.md)