> ## 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)

使用此工具開始與停止遊戲擷取，並將檔案儲存至主機暫存磁碟機 (例如 `xd:\clips\file.mp4`)。

> [!NOTE]
>
> 您也可以使用 [XBOX Manager](/zh-TW/tools/tools-console/xbom/xbom) 工具擷取視訊並儲存至本機 PC。

| 命令 | 描述 |
| - | - |
| [start](#wdcapturesession_start) | 開始擷取工作階段。 |
| [stop]() | 停止擷取工作階段，並完成將檔案寫入磁碟。如果偵測到磁碟空間不足，會自動呼叫此命令。 |

## wdcapturesession start

開始擷取工作階段，並以 MP4 檔案格式將其儲存至暫存磁碟機。

`FilePath` 是選擇性參數，路徑預設為 `d:\clips\sessionvideo_[timestamp].mp4`。`FilePath` 的名稱需要 MP4 副檔名。如果您未指定路徑，檔案會寫入 `d:\clips` 路徑。

`Max duration in seconds` 為選擇性，預設為 3,600 秒。

在擷取作用中工作階段期間呼叫 `start` 會傳回錯誤 "Error: Cannot start session capture, Recording in Progress" (0x8C111120)。

`wdcapturesession start /f:<filepath> /d:<maxduration in seconds> /autostop`

| 選項 | 描述 |
| - | - |
| `f` | 輸出檔案的路徑與名稱 |
| `d` | 指定工作階段擷取的最大持續時間 (秒)。預設為 3600。 |
| `autostop` | 在遊戲結束時自動停止擷取工作階段。此旗標為選擇性，且只適用於主機版本的 `wdcapturesession`。 |

## wdcapturesession stop

停止擷取工作階段，並完成將檔案寫入磁碟。如果偵測到磁碟空間不足，會自動呼叫此命令。

`wdcapturesession stop `

## 搭配 wdcapturesession 使用即時訊息通訊協定 (RTMP)

RTMP 是一種音訊/視訊串流通訊協定，適用於封存用途 (例如執行測試) 以及直播。

> [!NOTE]
>
> RTMP 不支援加密。請勿使用它透過公用網際網路傳輸機密資訊。

例如，適合的命令可能是 `wdcapturesession start /f:rtmp://servername/live/streamname`。

與現有情境類似，`wdcapturesession stop` 會停止串流工作階段、發佈串流，然後關閉與伺服器的連線。此功能僅限於開發套件。

RTMP 有下列限制：

* 預設的最長時間限制為 1 小時 (3,600 秒)。如果您想要更長的錄製時間，請使用 `/d:` 選項。
* 視訊會以 H264 格式、HD 解析度、30 fps、約 5 Mbps 傳送。
* 音訊會以 AAC 立體聲音訊傳送。

支援僅限於未加密的連線，因此請只在內部網路上分享機密內容。此功能可搭配 Google Cloud Service、nginx-rtmp 與 YouTube RTMP 伺服器使用。

例如，`YouTube` 在接收 `wdcapturesession` 的輸出時，需要此選項從預設切換為 `"live"` 發佈模式。

適合的 URL 可能是 `rtmp://servername/live/streamkey?publishmode=live`。

## 另請參閱

[主機命令列工具](/zh-TW/tools/tools-console/console_commandlinetools/consolecommandlinetools)

[XTF 傳輸錯誤](/zh-TW/tools/tools-console/commandlinetools/xtf-transport-errors)


## Related topics

- [主機型命令列工具](/zh-TW/tools/tools-console/console_commandlinetools/consolecommandlinetools.md)
- [影片擷取 (wdcapturesession.exe)](/zh-TW/tools/tools-pc/commandlinetools/gr-wdcapturesession.md)
- [適用於 XBOX 的主機型命令列工具](/zh-TW/tools/tools-console/console_commandlinetools/index.md)
- [PC 開發的命令列工具](/zh-TW/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md)
- [命令列工具](/zh-TW/tools/tools-pc/commandlinetools/index.md)