> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 视频捕获 (wdcapturesession.exe)

> 视频捕获 (wdcapturesession.exe)

`wdcapturesession` 是一个 PC 命令行工具,用于在游戏测试期间录制实时视频。它以每秒 30 帧的速率编码为 H.264 或 HEVC,并输出为 `.mp4` 格式。

## 先决条件

* Windows 10 或更高版本,支持 Windows Graphics Capture。

## 用法

`wdcapturesession` 工具支持以下命令行参数:

| 命令                                                      | 说明                |
| ------------------------------------------------------- | ----------------- |
| [wdcapturesession start](#wdcapturesession-start)       | 启动视频捕获会话。         |
| [wdcapturesession stop]()                               | 停止视频捕获会话。         |
| [wdcapturesession status](#wdcapturesession-status)     | 显示当前视频捕获状态。       |
| [wdcapturesession list-displays]()                      | 列出所有显示器索引。        |
| [wdcapturesession feedback](#wdcapturesession-feedback) | 打开反馈中心应用以报告错误或建议。 |

## wdcapturesession start

启动视频捕获会话。

`wdcapturesession start  [--filepath <filepath>] [--duration <max-duration>] [--monitor <monitor>]`

| 选项                       | 说明                                                                    |
| ------------------------ | --------------------------------------------------------------------- |
| `--filepath`, `-f`, `/f` | 输出 `.mp4` 文件的路径。如果未指定,将自动生成带时间戳的文件名。                                  |
| `--duration`, `-d`, `/d` | 最大录制秒数。最小为 10 秒。默认为 3600 秒(1 小时)。                                     |
| `--monitor`, `-m`, `/m`  | 要捕获的显示器索引。使用 `wdcapturesession list-displays` 查看可用的显示器。如果未指定,则使用主显示器。 |

## wdcapturesession stop

停止视频捕获会话并完成向 `.mp4` 文件的写入。如果没有正在进行的捕获会话,此操作将失败。

`wdcapturesession stop`

## wdcapturesession status

显示当前视频捕获会话状态。

`wdcapturesession status`

## wdcapturesession list-displays

列出所有显示器索引。

`wdcapturesession list-displays`

## wdcapturesession feedback

打开反馈中心应用以报告 XBOX 游戏开发错误或建议。

`wdcapturesession feedback`

[返回本文顶部。](/tools/tools-pc/commandlinetools/gr-wdcapturesession)

## 备注

有关安装和启动 PC 版 Microsoft 游戏开发工具包 (GDK) 游戏的更多信息,请参阅 [使用 Microsoft 游戏开发工具包工具安装并启动 PC 游戏](/tools/tools-pc/launching-on-pc)。


## Related topics

- [命令行工具](/zh-CN/tools/tools-pc/commandlinetools/index.md)
- [PC 开发的命令行工具](/zh-CN/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md)
- [长时间游戏捕获 (wdcapturesession.exe)](/zh-CN/tools/tools-console/console_commandlinetools/wdcapturesession.md)
- [基于主机的命令行工具](/zh-CN/tools/tools-console/console_commandlinetools/consolecommandlinetools.md)
- [XAppCaptureVideoEncoding](/zh-CN/reference/system/xappcapture/enums/xappcapturevideoencoding.md)