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. - Se você não usar esta opção, será usado o console padrão (definido anteriormente por Conexão (xbconnect.exe)). - 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, 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. - 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
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.
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