XCEngine/docs/api/XCEngine/Debug/RenderDocCapture/LaunchReplayUI.md

# RenderDocCapture::LaunchReplayUI

请求启动 RenderDoc Replay UI。

```cpp
bool LaunchReplayUI(uint32_t connect = 1, const char* cmdline = nullptr);
```

## 行为说明

如果 RenderDoc 尚未加载，当前实现会记录警告并返回 `false`。否则会直接调用底层 `LaunchReplayUI(connect, cmdline)` 并返回 `true`。

注意：

- 底层 RenderDoc 函数本身没有返回值。
- 因此 XCEngine 无法确认 Replay UI 最终是否真的成功启动。

## 参数

- `connect` - 是否尝试连接到目标实例。
- `cmdline` - 传给 Replay UI 的可选命令行。

## 返回值

- `bool` - `true` 表示已发出启动请求；`false` 表示 RenderDoc 未加载。

## 线程语义

- 建议在工具线程或主线程的诊断分支中调用。

## 示例

```cpp
XCEngine::Debug::RenderDocCapture::Get().LaunchReplayUI();
```

## 相关文档

- [返回类型总览](RenderDocCapture.md)
- [GetCapture](GetCapture.md)