Connexion (xbconnect.exe) - XBOX Game Development Documentation

Utilisez cet outil pour définir ou interroger l’adresse de la console par défaut utilisée par les outils distants du Microsoft Game Development Kit (GDK).

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

Option	Description
/B	Affiche uniquement le nom ou l’adresse de la console, au format brut.
/S	Affiche uniquement le nom ou l’adresse du système, au format brut.
/T	Affiche uniquement le nom ou l’adresse de l’outil, au format brut.
/N	Ne tente pas de se connecter à l’adresse cible.
/D	Affiche les extensions inscrites et les informations de build du processus.
/DX	Exécute des tests de diagnostic pour évaluer l’état de la connexion entre le PC et le kit de développement XBOX. Pour plus de renseignements, consultez la section Détails des tests de diagnostic de Connect plus loin dans cette rubrique.
/Q	Effectue uniquement une interrogation et n’inscrit pas d’adresse par défaut, même si une adresse est fournie. Généralement utilisée avec /D pour une interrogation directe sans modifier le paramètre de console par défaut.
/QG	Indique si le Title OS (Game OS) est en cours d’exécution. Effectue uniquement une interrogation et n’inscrit pas d’adresse par défaut, même si une adresse est fournie. /QG est généralement utilisée par les scripts pour déterminer l’état du Title OS afin de choisir la méthode appropriée d’accès aux fichiers du titre. Dans les scripts, ERRORLEVEL est défini sur 0 si le titre est en cours d’exécution, et sur 1 dans le cas contraire. Consultez la section Vérification de l’état du Title OS dans un script pour un exemple de vérification de l’état du Title OS dans un script.
/WS[:sec]	• Bloque xbconnect jusqu’à ce que le System OS soit prêt pour l’interaction ou que le délai d’expiration soit atteint. • Le délai d’expiration par défaut est de 120 secondes. Il est possible de spécifier une valeur personnalisée, par exemple xbconnect /WS:200. • Retourne ERRORLEVEL=0 si la console est prête ou ERRORLEVEL=1 si le délai d’expiration est atteint. • Offre un moyen fiable de déterminer quand une console est prête à recevoir des commandes, par exemple pour savoir quand appeler xbapp launch après xbreboot. • Pour attendre indéfiniment, utilisez -1 ou “infinite”.
/WTP[:sec]	• Bloque xbconnect jusqu’à ce que le processus du titre soit prêt pour l’interaction. Le délai d’expiration par défaut est de 300 secondes et peut être configuré en fournissant une valeur facultative approximative en secondes (ex. : /WTP:200). Utilisez la valeur -1 ou ‘infinite’ pour attendre indéfiniment.
/WT[:sec]	• Bloque xbconnect jusqu’à ce que le Game OS soit prêt pour l’interaction ou que le délai d’expiration soit atteint. • Le délai d’expiration par défaut est de 120 secondes. Il est possible de spécifier une valeur personnalisée, par exemple xbconnect /WT:200. • Retourne ERRORLEVEL=0 si la console est prête ou ERRORLEVEL=1 si le délai d’expiration est atteint. • Offre un moyen fiable de déterminer quand le Game OS a terminé son initialisation et que le jeu a démarré. • Pour attendre indéfiniment, utilisez -1 ou “infinite”.
/WTO[:sec]	• Bloque xbconnect jusqu’à ce que le Title OS soit prêt pour l’interaction. Le délai d’expiration par défaut est de 300 secondes et peut être configuré en fournissant une valeur facultative approximative en secondes (ex. : /WTO:200). Utilisez la valeur -1 ou ‘infinite’ pour attendre indéfiniment.
/discover [search string]	Recherche les consoles XBOX sur le réseau local, avec un filtre facultatif par sous-chaîne. La chaîne de recherche s’applique aux noms d’hôte des consoles, et non à leurs adresses IP.
/data	Retourne la vitesse de connexion entre le PC de développement et la console, en Mo/s.
/?	Affiche la liste complète des options disponibles.
address[+<accesskey>] [name]	address[+<accesskey>] spécifie le nom d’hôte ou l’adresse (Tools IP) d’une console cible. • La définition de l’adresse modifie la console par défaut, sauf si le commutateur /Q est spécifié. • Si aucune adresse n’est spécifiée, xbconnect affiche l’adresse par défaut actuellement stockée. • Pour plus de renseignements sur la définition d’un nom d’hôte sur une console, consultez Définir un nom d’hôte pour l’adresse IP de la console. Utilisez la chaîne accesskey pour limiter l’accès à la console aux seules personnes qui disposent de la clé d’accès. • Définissez la clé d’accès à l’aide de la commande xbconfig accesskey=your-key, puis redémarrez votre console pour que la clé d’accès prenne effet. • Pour accéder à une console configurée avec une clé d’accès, ajoutez un signe plus (+) suivi de la clé d’accès après l’adresse IP ou le nom d’hôte de la console. • Si une clé d’accès est fournie lors de la définition de la console par défaut avec xbconnect, la clé d’accès est stockée dans l’adresse de la console par défaut. • Pour plus de renseignements sur les clés d’accès, consultez xbconfig accesskey. Utilisez name pour spécifier le nom à associer à l’adresse. Si aucun nom n’est spécifié, xbconnect utilise “devkit” comme identificateur de console. L’address que les outils de développement doivent utiliser pour se connecter à une console apparaît en tant que Console IP sur la console. • Si address n’est pas spécifiée et qu’aucune adresse par défaut n’a été définie, xbconnect affiche un message d’erreur. • Si address n’est pas spécifiée et qu’une adresse par défaut a été définie, xbconnect tente de se connecter à l’adresse de la console par défaut. Cela permet de vérifier que la console par défaut est toujours accessible. • Lorsque vous appelez d’autres outils distants, vous pouvez remplacer l’adresse de la console par défaut en utilisant le commutateur /X pour spécifier un kit de développement.
/LC	Spécifiez le code de paramètres régionaux. Permet de remplacer le code de paramètres régionaux par défaut

Vérification de l’état du Title OS dans un 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

L’exécution du script produit la sortie suivante.

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  

Détails des tests de diagnostic de Connect

xbconnect /dx (diagnostics) exécute divers tests, à la fois localement sur le PC de développement et sur la console de développement, afin de déterminer la cause possible des problèmes de connexion. Ces tests sont répartis en quatre groupes, chacun comportant des catégories de tests. Les échecs s’affichent en rouge avec un code d’erreur et un texte décrivant plus en détail ce code d’erreur. De plus, certains tests affichent des données supplémentaires qui peuvent être utiles pour la résolution des problèmes.

Tests du PC local

Les tests du PC local s’exécutent sur votre PC de développement et sont indépendants de la console de développement. Processus en cours d’exécution : vérifie les processus qui doivent être en cours d’exécution pour pouvoir travailler avec une console de développement XBOX. Les processus testés sont les suivants :

XbtpLinkSvc.exe
XrfsSvc.exe
[!NOTE] Ce processus spécifique peut ne pas être démarré, et il ne s’agit pas nécessairement d’un véritable échec.

Tests du PC vers la console

Les tests du PC vers la console partent du PC de développement et tentent de se connecter à la console de développement de différentes manières.

XbtpLink : vérifie que le protocole XBTP fonctionne entre le PC et la console, soit par le protocole TCP (Transmission Control Protocol), soit à l’aide d’un XBOX Transfer Device (XTD).
Query IP : demande à la console de retourner ses adresses IP connues.
Ping : tente d’envoyer une requête ping à la console cible sur l’adresse IP fournie, à l’aide du protocole ICMP (Internet Control Message Protocol) standard.
Port connections : tente de se connecter à un port ouvert sur lequel s’exécute un service de la console de développement. Ces services et ports sont les suivants :
- XTF (XBOX Tools Framework): Port 4201/4211/4221
- VS Debugger (Visual Studio Remote Debugger): Ports 4024/4022/4020/4016
- Video Server (serveur vidéo distant utilisé par XBOX Manager) : port 11442
- WDP (Windows Device Portal pour XBOX) : port 11443

Tests de la console

Les tests de la console s’exécutent sur la console distante et sont indépendants du PC de développement.

Debug NIC : détermine si le port réseau de débogage de la console est utilisé en plus du port réseau commercial.
Process running : vérifie les processus qui doivent être en cours d’exécution sur la console de développement. Ces processus incluent Xtfhost.exe.

Tests de la console vers le PC

Les tests de la console vers le PC partent de la console de développement et tentent de se connecter au PC de développement de différentes manières.

Ping : tente d’envoyer une requête ping au PC de développement cible à l’aide des adresses IP fournies par le PC.
[!NOTE] Toutes les adresses routables du PC sont essayées, mais toutes ne sont pas nécessairement routables depuis la console de développement XBOX. Il n’est pas rare que ce test échoue pour certaines adresses.
XbtpLink : vérifie que le protocole XBTP fonctionne entre le PC de développement et la console de développement, soit par TCP, soit à l’aide d’un XTD.

Exemple de sortie de diagnostic

Un exemple de sortie de diagnostic est présenté dans la capture d’écran suivante.

Capture d'écran des diagnostics de xbconnect

Voir aussi

Outils en ligne de commande Copie de fichiers (xbcp.exe) Répertoire (xbdir.exe) Informations de diagnostic (xbdiaginfo.exe)

​Vérification de l’état du Title OS dans un script

​Détails des tests de diagnostic de Connect

​Tests du PC local

​Tests du PC vers la console

​Tests de la console

​Tests de la console vers le PC

​Exemple de sortie de diagnostic

​Voir aussi