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

# Capturas de jogo de longa duração (wdcapturesession.exe)

> Capturas de jogo de longa duração (wdcapturesession.exe)

Use esta ferramenta para iniciar e interromper capturas do seu jogo e salvar o arquivo na unidade de rascunho do console (por exemplo, `xd:\clips\file.mp4`).

<Note>
  Você também pode usar a ferramenta [XBOX Manager](/pt-BR/tools/tools-console/xbom/xbom) para capturar vídeo e salvá-lo no seu PC local.
</Note>

| Comando | Descrição |
| - | - |
| [start](#wdcapturesession_start) | Inicia uma sessão de captura. |
| [stop]() | Interrompe uma sessão de captura e conclui a gravação do arquivo em disco. O comando é chamado automaticamente se for detectado pouco espaço em disco. |

<a id="wdcapturesession_start" />

## wdcapturesession start

Inicia uma sessão de captura e a salva na unidade de rascunho no formato de arquivo MP4.

`FilePath` é um parâmetro opcional cujo caminho padrão é `d:\clips\sessionvideo_[timestamp].mp4`. `FilePath` requer uma extensão MP4 no nome. Se você não especificar um caminho, o arquivo será gravado no caminho `d:\clips`.

`Max duration in seconds` é opcional e o padrão é 3.600 segundos.

Chamar `start` enquanto uma sessão ativa estiver sendo capturada retorna o erro "Error: Cannot start session capture, Recording in Progress" (0x8C111120).

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

| Opção | Descrição |
| - | - |
| `f` | O caminho e o nome do arquivo de saída |
| `d` | Especifica a duração máxima (em segundos) da captura da sessão. O padrão é 3600. |
| `autostop` | Interrompe automaticamente a sessão de captura quando o título do jogo é encerrado. Esse sinalizador é opcional e só se aplica à versão de console do `wdcapturesession`. |

<a id="wdcapturesession_stop" />

## wdcapturesession stop

Interrompe uma sessão de captura e conclui a gravação do arquivo em disco. Será chamado automaticamente se for detectado pouco espaço em disco.

`wdcapturesession stop `

## Usar o Real-time Messaging Protocol (RTMP) com o wdcapturesession

O RTMP é um protocolo de streaming de áudio/vídeo adequado para fins de arquivamento, como a execução de testes, e para streaming ao vivo.

<Note>
  O RTMP não dá suporte à criptografia. Não o use para transmitir informações confidenciais pela internet pública.
</Note>

Por exemplo, um comando adequado poderia ser `wdcapturesession start /f:rtmp://servername/live/streamname`.

Assim como nos cenários existentes, `wdcapturesession stop` interrompe a sessão de streaming, publica o stream e, em seguida, fecha a conexão com o servidor.  Esse recurso é restrito a devkits.

O RTMP tem as seguintes limitações:

* Um limite de tempo máximo padrão de 1 hora (3.600 segundos). Use a opção `/d:` se quiser uma gravação mais longa.
* O vídeo é enviado no formato H264 em resolução HD, 30 fps, cerca de 5 Mbps.
* O áudio é enviado como áudio estéreo AAC.

O suporte é limitado a conexões não criptografadas, portanto compartilhe conteúdo confidencial somente em redes internas. Esse recurso funciona com os servidores RTMP do Google Cloud Service, nginx-rtmp e YouTube.

Por exemplo, o `YouTube` exige essa opção para alternar do modo de publicação padrão para `"live"` ao receber a saída do `wdcapturesession`.

Uma URL adequada poderia ser `rtmp://servername/live/streamkey?publishmode=live`.

## Veja também

[Ferramentas de linha de comando do console](/pt-BR/tools/tools-console/console_commandlinetools/consolecommandlinetools)

[Erros de transporte do XTF](/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors)


## Related topics

- [Ferramentas de linha de comando baseadas no console](/pt-BR/tools/tools-console/console_commandlinetools/consolecommandlinetools.md)
- [Captura de vídeo (wdcapturesession.exe)](/pt-BR/tools/tools-pc/commandlinetools/gr-wdcapturesession.md)
- [Ferramentas de linha de comando para o desenvolvimento para PC](/pt-BR/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md)
- [Ferramentas de linha de comando](/pt-BR/tools/tools-pc/commandlinetools/index.md)
- [Ferramentas de linha de comando baseadas no console para XBOX](/pt-BR/tools/tools-console/console_commandlinetools/index.md)