Conexão (xbconnect.exe) - XBOX Game Development Documentation

Use esta ferramenta para definir ou consultar o endereço do console padrão usado pelas ferramentas remotas do Microsoft Game Development Kit (GDK).

Coluna 1
xbconnect [/B] [/S] [/T] [/N] [/D] [/Q] [/QG] [/WS[:sec] ] [/WTP[:sec] ] [/WT[:sec] ] [/WTO[:sec] ] [/discover [search string] ] [/data] [/?] [address[+<accesskey>] [name]]

Opção	Descrição
/B	Mostra somente o nome ou o endereço do console e usa o formato simples.
/S	Mostra somente o nome ou o endereço do System e usa o formato simples.
/T	Mostra somente o nome ou o endereço da ferramenta e usa o formato simples.
/N	Não tenta se conectar ao endereço de destino.
/D	Mostra as extensões registradas e as informações de build do processo.
/DX	Executa testes de diagnóstico para avaliar a integridade da conexão entre o PC e o XBOX Development Kit. Para obter mais informações, veja a seção Detalhes sobre os testes de diagnóstico do Connect mais adiante neste tópico.
/Q	Executa somente a consulta e não registra um endereço padrão, mesmo que um endereço seja fornecido. Normalmente é usada com /D para consulta direta sem afetar a configuração do console padrão.
/QG	Consulta se o Title OS (Game OS) está em execução. Executa somente a consulta e não registra um endereço padrão, mesmo que um endereço seja fornecido. /QG normalmente é usada por scripts para determinar o estado do Title OS a fim de escolher o método correto para acessar os arquivos do título. Nos scripts, ERRORLEVEL é definido como 0 se o título estiver em execução. Caso contrário, é definido como 1. Veja a seção Verificar o estado do Title OS em um script para obter um exemplo de verificação do estado do Title OS em um script.
/WS[:sec]	• Faz com que o xbconnect bloqueie até que o System OS esteja pronto para interação ou o tempo limite seja atingido. • O tempo limite padrão é de 120 segundos. Há uma opção para especificar um valor personalizado, como xbconnect /WS:200. • Retorna ERRORLEVEL=0 se o console estiver pronto ou ERRORLEVEL=1 se o tempo limite for atingido. • Oferece uma forma confiável de determinar quando um console está pronto para receber comandos, por exemplo, quando você pode chamar xbapp launch depois de xbreboot. • Para aguardar indefinidamente, use -1 ou “infinite”.
/WTP[:sec]	• Faz com que o xbconnect bloqueie até que o processo do título esteja pronto para interação. O tempo limite padrão é de 300 segundos e pode ser configurado fornecendo um valor de tempo limite opcional aproximado em segundos (ex.: /WTP:200). Use o valor -1 ou ‘infinite’ para aguardar indefinidamente.
/WT[:sec]	• Faz com que o xbconnect bloqueie até que o Game OS esteja pronto para interação ou o tempo limite seja atingido. • O tempo limite padrão é de 120 segundos. Há uma opção para especificar um valor personalizado, como xbconnect /WT:200. • Retorna ERRORLEVEL=0 se o console estiver pronto ou ERRORLEVEL=1 se o tempo limite for atingido. • Oferece uma forma confiável de determinar quando o Game OS concluiu a inicialização e o jogo foi iniciado. • Para aguardar indefinidamente, use -1 ou “infinite”.
/WTO[:sec]	• Faz com que o xbconnect bloqueie até que o Title OS esteja pronto para interação. O tempo limite padrão é de 300 segundos e pode ser configurado fornecendo um valor de tempo limite opcional aproximado em segundos (ex.: /WTO:200). Use o valor -1 ou ‘infinite’ para aguardar indefinidamente.
/discover [search string]	Pesquisa consoles XBOX na LAN, filtrados por uma substring opcional. A string de pesquisa se aplica aos nomes de host dos consoles, não aos endereços IP.
/data	Retorna a velocidade de conexão do PC de desenvolvimento com o console em MBps.
/?	Mostra uma lista completa das opções disponíveis.
address[+<accesskey>] [name]	address[+<accesskey>] especifica o nome do host ou o endereço (Tools IP) de um console de destino. • Definir o endereço altera o console padrão, a menos que a opção /Q seja especificada. • Se nenhum endereço for especificado, o xbconnect mostrará o endereço padrão armazenado atualmente. • Para obter detalhes sobre como definir um nome de host em um console, veja Definir um nome de host para o endereço IP do console. 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 com o 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. Use name para especificar o nome a ser associado ao endereço. Se nenhum nome for especificado, o xbconnect usará “devkit” como identificador do console. O address que as ferramentas de desenvolvimento devem usar para se conectar a um console aparece como Console IP no console. • Se address não for especificado e um endereço padrão não tiver sido definido, o xbconnect mostrará uma mensagem de erro. • Se address não for especificado e um endereço padrão tiver sido definido, o xbconnect tentará se conectar ao endereço do console padrão. Isso pode ser usado para verificar se o console padrão ainda está acessível. • Ao invocar outras ferramentas remotas, você pode substituir o endereço do console padrão usando a opção /X para especificar um kit de desenvolvimento.
/LC	Especifica o código de localidade. Usado para substituir o código de localidade padrão

Verificar o estado do Title OS em um script

@xbconnect /QG > nul
@if ERRORLEVEL=1 GOTO SYSTEM

@echo Title running
@echo using xbcp
@GOTO ENDD

@:SYSTEM
@echo Title not running
@echo using robocopy 
@GOTO ENDD

@:ENDD
@echo Done

A execução do script produz a saída a seguir.

C:\Scratch\D\GXDK\SigninUser\temp>testqg.bat
Title not running
using robocopy
Done
C:\Scratch\D\GXDK\SigninUser\temp>testqg.bat
Title running
using xbcp
Done  

Detalhes sobre os testes de diagnóstico do Connect

xbconnect /dx (diagnóstico) executa vários testes, tanto localmente no PC de desenvolvimento quanto no console de desenvolvimento, para determinar o que pode estar causando problemas de conexão. Esses testes são separados em quatro grupos, com categorias de testes executadas em cada grupo. As falhas são exibidas em vermelho junto com um código de erro e um texto que descreve o código de erro com mais detalhes. Além disso, alguns testes exibem mais dados que podem ser úteis para a solução de problemas.

Testes no PC local

Os testes no PC local são executados no seu PC de desenvolvimento e são independentes do console de desenvolvimento. Processos em execução: teste dos processos que devem estar em execução para permitir o trabalho com um console de desenvolvimento XBOX. Os processos testados incluem os seguintes:

XbtpLinkSvc.exe
XrfsSvc.exe
[!NOTE] Esse processo específico pode não estar iniciado, e isso não é necessariamente uma falha real.

Testes do PC para o console

Os testes do PC para o console se originam no PC de desenvolvimento e tentam se conectar ao console de desenvolvimento de várias formas.

XbtpLink: testa se o protocolo XBTP está funcionando entre o PC e o console, via Transmission Control Protocol (TCP) ou usando um XBOX Transfer Device (XTD).
Query IP: solicita ao console que retorne seus endereços IP conhecidos.
Ping: tenta executar ping no console de destino no endereço IP fornecido usando o Internet Control Message Protocol (ICMP) padrão.
Port connections: tenta se conectar a uma porta aberta que executa um serviço no console de desenvolvimento. Esses serviços e portas incluem os seguintes:
- XTF (XBOX Tools Framework): porta 4201/4211/4221
- VS Debugger (Visual Studio Remote Debugger): portas 4024/4022/4020/4016
- Video Server (servidor de vídeo remoto usado pelo XBOX Manager): porta 11442
- WDP (Windows Device Portal para XBOX): porta 11443

Testes no console

Os testes no console são executados no console remoto e são independentes do PC de desenvolvimento.

Debug NIC: determina se a porta de rede de depuração do console está sendo usada além da porta de rede de varejo.
Process running: testa os processos que devem estar em execução no console de desenvolvimento. Esses processos incluem o Xtfhost.exe.

Testes do console para o PC

Os testes do console para o PC se originam no console de desenvolvimento e tentam se conectar ao PC de desenvolvimento de várias formas.

Ping: tenta executar ping no PC de desenvolvimento de destino usando os endereços IP fornecidos pelo PC.
[!NOTE] Todos os endereços roteáveis do PC são testados, mas nem todos os endereços seriam roteáveis a partir do console de desenvolvimento XBOX. Falhas de endereços específicos neste teste não são incomuns.
XbtpLink: testa se o protocolo XBTP está funcionando entre o PC de desenvolvimento e o console de desenvolvimento, via TCP ou usando um XTD.

Exemplo de saída de diagnóstico

Um exemplo de saída de diagnóstico é mostrado na captura de tela a seguir.

Captura de tela do diagnóstico do xbconnect

Veja também

Ferramentas de linha de comando Cópia de arquivos (xbcp.exe) Diretório (xbdir.exe) Informações de diagnóstico (xbdiaginfo.exe)

​Verificar o estado do Title OS em um script

​Detalhes sobre os testes de diagnóstico do Connect

​Testes no PC local

​Testes do PC para o console

​Testes no console

​Testes do console para o PC

​Exemplo de saída de diagnóstico

​Veja também