> ## 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](/tools/tools-console/xbom/xbom) 도구를 사용하여 비디오를 캡처하고 로컬 PC에 저장할 수도 있습니다.
</Note>

| 명령                               | 설명                                                                     |
| -------------------------------- | ---------------------------------------------------------------------- |
| [start](#wdcapturesession_start) | 캡처 세션을 시작합니다.                                                          |
| [stop]()                         | 캡처 세션을 중지하고 파일을 디스크에 기록하는 작업을 완료합니다. 디스크 공간 부족이 감지되면 이 명령이 자동으로 호출됩니다. |

<a id="wdcapturesession_start" />

## 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`의 콘솔 버전에만 적용됩니다. |

<a id="wdcapturesession_stop" />

## wdcapturesession stop

캡처 세션을 중지하고 파일을 디스크에 기록하는 작업을 완료합니다. 디스크 공간 부족이 감지되면 자동으로 호출됩니다.

`wdcapturesession stop `

## wdcapturesession과 실시간 메시징 프로토콜(RTMP) 사용

RTMP는 테스트 실행 및 라이브 스트리밍과 같은 아카이브 목적에 적합한 오디오/비디오 스트리밍 프로토콜입니다.

<Note>
  RTMP는 암호화를 지원하지 않습니다. 공용 인터넷을 통해 기밀 정보를 전송하는 데 사용하지 마십시오.
</Note>

예를 들어 적절한 명령은 `wdcapturesession start /f:rtmp://servername/live/streamname`일 수 있습니다.

기존 시나리오와 유사하게, `wdcapturesession stop`은 스트리밍 세션을 중지하고, 스트림을 게시하고, 서버에 대한 연결을 닫습니다. 이 기능은 개발 키트에 국한됩니다.

RTMP에는 다음과 같은 제한 사항이 있습니다:

* 기본 최대 시간 제한은 1시간(3,600초)입니다. 더 긴 녹화를 원하면 `/d:` 옵션을 사용하십시오.
* 비디오는 HD 해상도, 30fps, 약 5Mbps로 H264 형식으로 전송됩니다.
* 오디오는 AAC 스테레오 오디오로 전송됩니다.

지원은 암호화되지 않은 연결로 제한되므로 내부 네트워크에서만 기밀 콘텐츠를 공유하십시오. 이 기능은 Google Cloud Service, nginx-rtmp, YouTube RTMP 서버에서 작동합니다.

예를 들어 `YouTube`는 `wdcapturesession`에서 출력을 받을 때 기본값에서 `"live"` 게시 모드로 전환하려면 이 옵션이 필요합니다.

적절한 URL은 `rtmp://servername/live/streamkey?publishmode=live`일 수 있습니다.

## 참고 항목

[콘솔 명령줄 도구](/tools/tools-console/console_commandlinetools/consolecommandlinetools)

[XTF 전송 오류](/tools/tools-console/commandlinetools/xtf-transport-errors)


## Related topics

- [콘솔 기반 명령줄 도구](/ko/tools/tools-console/console_commandlinetools/consolecommandlinetools.md)
- [비디오 캡처 (wdcapturesession.exe)](/ko/tools/tools-pc/commandlinetools/gr-wdcapturesession.md)
- [PC 개발용 명령줄 도구](/ko/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md)
- [명령줄 도구](/ko/tools/tools-pc/commandlinetools/index.md)
- [화면 캡처 (wdcapture.exe)](/ko/tools/tools-pc/commandlinetools/gr-wdCapture.md)