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

# Gerenciar streaming de jogos (xbgamestream.exe)

> Gerenciar streaming de jogos (xbgamestream.exe)

Use esta ferramenta para consultar se um console está atualmente habilitado para streaming de jogos e para gerenciar esse estado.

## Comandos

| Comando | Descrição |
| :- | :- |
| listconfigs | Lista as configurações base de streaming com suporte no console. |
| startlistening | Começa a escutar conexões de streaming de conexão direta no console. |
| stoplistening | Para de escutar conexões de streaming de conexão direta no console. |
| status | Consulta o status de streaming do console. |
| enableremoteconnect | Habilita o remote connect para o usuário especificado. Essa configuração persiste após a reinicialização do dispositivo. |
| disableremoteconnect | Desabilita o remote connect para o usuário especificado. Essa configuração persiste após a reinicialização do dispositivo. |
| remoteconnectstatus | Consulta o status do remote connect para o usuário especificado. |
| setconfigoverride | Define uma ou mais substituições de configuração da configuração base do stream. A configuração base do stream para conexão direta é especificada pelo parâmetro 'config' do comando 'startlistening'. A configuração base do stream para remote connect é determinada pelos serviços XBOX. As substituições de configuração são aplicadas em 'startlistening' para conexão direta e em novas conexões de stream para remote connect. As substituições não persistem entre reinicializações e precisam ser redefinidas após a reinicialização, se desejado. |
| clearconfigoverride | Limpa uma ou mais substituições de configuração definidas com o comando 'setconfigoverride'. |
| dumpconfigoverride | Grava no console todas as substituições de configuração definidas pelo comando 'setconfigoverride'. |
| /LC | Especifica o código de localidade. Usado para substituir o código de localidade padrão |

## Sinalizadores globais

Os sinalizadores da tabela a seguir se aplicam a todos os comandos.

| Coluna 1 |
| - |
| **xbgamestream** \[/X\[*:address*] \[*+accesskey*] ] |

| Sinalizador | Descrição |
| - | - |
| /X\[*:address*] \[*+accesskey*] | - Use esta opção para especificar o nome do host ou o endereço (mostrado como **Tools IP** no console) de um console de destino sem alterar o console padrão. Para obter detalhes sobre como definir um nome de host para um console, veja [Definir um nome de host para o endereço IP do console](https://docs.xbox.com/pt-BR/home/setup-install/dev-kit-settings/setting-a-hostname.md). - Se você não usar esta opção, será usado o console padrão (definido anteriormente por [Conexão (xbconnect.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconnect.md)). - Use a string *accesskey* para fornecer acesso ao console somente às pessoas que têm a chave de acesso. - Defina a chave de acesso usando o comando **xbconfig** **accesskey=your-key** e, em seguida, reinicie o console para que a chave de acesso entre em vigor. - Para acessar um console configurado com uma chave de acesso, inclua um sinal de adição (+) e a chave de acesso após o endereço IP ou o nome do host do console. - Se uma chave de acesso for fornecida quando o console padrão for definido por [xbconnect](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconnect.md), a chave de acesso será armazenada como parte do endereço do console padrão. - Para obter mais informações sobre chaves de acesso, veja [xbconfig accesskey](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconfig.md). - Se você acrescentar **/title** a **/X**, após o endereço ou sozinho, será usado o mapeamento de partições visto por um aplicativo exclusivo em execução. Por exemplo, especificar **/X/title xd:** daria acesso à partição da unidade de rascunho do console padrão que é visível para os aplicativos exclusivos em execução. |

## Detalhes dos comandos

### startlistening

> [!NOTE]
>
> Para obter a melhor compatibilidade, é recomendável **não** definir `version` ou `config`

| Parâmetro | Descrição |
| :- | :- |
| version | Parâmetro opcional que especifica a versão do protocolo a ser usada. O padrão é a versão de protocolo mais recente com suporte no console. |
| config | Parâmetro opcional para especificar a configuração de stream a ser usada. O padrão é a configuração de maior taxa de bits com suporte no Development Kit de destino. |

### status

| Sinalizador | Descrição |
| :- | :- |
| /B | Especifica o formato simples. Quando habilitado, o comando **status** imprime somente uma saída simples. O modo simples deve ser usado com pelo menos um outro sinalizador, indicando quais dados de status você deseja recuperar (por exemplo, **/S**). |
| /S | Especifica somente o status de streaming. Quando habilitado, o comando **status** imprime somente o status de streaming do console. |

### enableremoteconnect

| Parâmetro | Descrição |
| :- | :- |
| accountEmail | Especifica a conta de e-mail para a qual o remote connect deve ser habilitado. Observe que essa conta deve estar conectada no momento no XBOX para habilitar o remote connect e deve ser usada ao entrar no cliente de streaming. |

### disableremoteconnect

| Parâmetro | Descrição |
| :- | :- |
| accountEmail | Especifica a conta de e-mail para a qual o remote connect deve ser desabilitado. Observe que essa deve ser uma conta com a qual se entrou anteriormente. |

### remoteconnectstatus

| Parâmetro | Descrição |
| :- | :- |
| accountEmail | Especifica a conta de e-mail para a qual o status do remote connect deve ser recuperado. |

### setconfigoverride

| Parâmetro | Descrição |
| :- | :- |
| allowDirectCapture | Booleano opcional que habilita ou desabilita a captura direta. Valor padrão: *true*. |
| maxBitrate | Parâmetro opcional que substitui a taxa de bits máxima do stream. Valor de exemplo: *12000000*. |
| minBitrate | Parâmetro opcional que substitui a taxa de bits mínima do stream. Valor de exemplo: *6000000*. |
| maxResolution | Parâmetro opcional que substitui a resolução máxima sugerida do stream de vídeo. Valores de exemplo: *720p*, *1080p*. |
| minResolution | Parâmetro opcional que substitui a resolução mínima sugerida do stream de vídeo. Valores de exemplo: *720p*, *1080p*. |

### clearconfigoverride

| Parâmetro | Descrição |
| :- | :- |
| allowDirectCapture | Parâmetro opcional para limpar a substituição da captura direta. |
| maxBitrate | Parâmetro opcional para limpar a substituição da taxa de bits máxima. |
| minBitrate | Parâmetro opcional para limpar a substituição da taxa de bits mínima. |
| maxResolution | Parâmetro opcional para limpar a substituição da resolução máxima. |
| minResolution | Parâmetro opcional para limpar a substituição da resolução mínima. |

| Sinalizador | Descrição |
| :- | :- |
| /A | Limpa todas as substituições. |

## Exemplos

Os exemplos a seguir mostram algumas das formas de usar o **xbgamestream**.

```text theme={null}

C:\Working Directory> xbgamestream status
Game Streaming Server Status:
Not Listening

C:\Working Directory> xbgamestream listconfigs
default    : xxxx Default
5.5mbps    : Max 1280 x 720 @5.5Mbps
12mbps     : Max 1920 x 1080 @12Mbps

C:\Working Directory> xbgamestream startlistening
Listening started

C:\Working Directory> xbgamestream stoplistening
Listening stopped

C:\Working Directory> xbgamestream startlistening /X:255.255.255.255
Listening started

C:\Working Directory> xbgamestream status /X:255.255.255.255
Game Streaming Server Status:
Listening
  - Protocol Version: ANY
  - Stream Configuration: default

C:\Working Directory> xbgamestream status /B /S /X:255.255.255.255
Listening

C:\Working Directory> xbgamestream enableremoteconnect accountEmail=xxxx@y.com
Remote connect enabled for account xxxx@y.com

C:\Working Directory> xbgamestream disableremoteconnect accountEmail=xxxx@y.com
Remote connect disabled for account xxxx@y.com

C:\Working Directory> xbgamestream remoteconnectstatus accountEmail=xxxx@y.com
Remote connect status for account xxxx@y.com: enabled

C:\Working Directory> xbgamestream setconfigoverride maxBitrate=12000000 minBitrate=6000000
Stream config override(s) set

C:\Working Directory> xbgamestream setconfigoverride minResolution=1080p
Stream config override(s) set

C:\Working Directory> xbgamestream clearconfigoverride maxBitrate minBitrate
Stream config override(s) cleared

C:\Working Directory> xbgamestream clearconfigoverride /A
Stream config override(s) cleared

C:\Working Directory> xbgamestream dumpconfigoverride
maxBitrate           : 12000000
minBitrate           : 6000000
minResolution        : 1080p
```

## Veja também

[Gerenciar streaming de jogos (wdgamestream.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/console_commandlinetools/wdgamestream.md)

[Ferramentas de linha de comando](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/commandlinetools.md)

[Erros de transporte do XTF](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors.md)


## Related topics

- [Gerenciar streaming de jogos (wdgamestream.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/console_commandlinetools/wdgamestream.md)
- [Página Streaming (Dev Home)](https://docs.xbox.com/pt-BR/tools/tools-console/devhome/devhome-streaming.md)
- [Ferramentas de linha de comando](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/index.md)
- [Ferramentas de linha de comando para desenvolvimento em console](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/commandlinetools.md)
- [Ferramentas de linha de comando baseadas no console](https://docs.xbox.com/pt-BR/tools/tools-console/console_commandlinetools/consolecommandlinetools.md)
