Connect (xbconnect.exe) - XBOX Game Development Documentation

使用此工具设置或查询 Microsoft Game Development Kit (GDK) 远程工具所使用的默认主机地址。

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

选项	说明
/B	仅显示主机的名称或地址，并使用简单格式。
/S	仅显示 System 名称或地址，并使用简单格式。
/T	仅显示工具的名称或地址，并使用简单格式。
/N	不尝试连接到目标地址。
/D	显示已注册的扩展和进程构建信息。
/DX	运行诊断测试以评估 PC 与 XBOX 开发工具包之间的连接健康状况。有关更多信息，请参阅本主题稍后的 Connect 诊断测试详情部分。
/Q	仅执行查询，即便提供了地址也不注册默认地址。通常与 /D 一起使用，用于直接查询而不影响默认主机设置。
/QG	查询 Title OS (Game OS) 是否正在运行。仅执行查询，即便提供了地址也不注册默认地址。 /QG 通常由脚本使用，用于确定 Title OS 的状态，以选择访问游戏文件的正确方法。在脚本中，如果游戏正在运行则 ERRORLEVEL 设为 0，否则设为 1。有关在脚本中检查 Title OS 状态的示例，请参阅在脚本中检查 Title OS 的状态部分。
/WS[:sec]	• 使 xbconnect 阻塞，直到 System OS 已准备好可交互或达到超时。 • 默认超时为 120 秒。可以选择指定自定义值，例如 xbconnect /WS:200。 • 如果主机已就绪，则返回 ERRORLEVEL=0；如果达到超时，则返回 ERRORLEVEL=1。 • 提供了一种可靠的方法来判断主机何时可以接收命令，例如在 xbreboot 之后何时可以调用 xbapp launch。 • 若要无限期等待，请使用 -1 或 “infinite”。
/WTP[:sec]	• 使 xbconnect 阻塞，直到游戏进程已准备好可交互。默认超时为 300 秒，可通过提供一个大致的可选超时值（秒）进行配置（例如：/WTP:200）。使用值 -1 或 ‘infinite’ 无限期等待。
/WT[:sec]	• 使 xbconnect 阻塞，直到 Game OS 已准备好可交互或达到超时。 • 默认超时为 120 秒。可以选择指定自定义值，例如 xbconnect /WT:200。 • 如果主机已就绪，则返回 ERRORLEVEL=0；如果达到超时，则返回 ERRORLEVEL=1。 • 提供了一种可靠的方法来判断 Game OS 何时完成初始化并且游戏已启动。 • 若要无限期等待，请使用 -1 或 “infinite”。
/WTO[:sec]	• 使 xbconnect 阻塞，直到 Title OS 已准备好可交互。默认超时为 300 秒，可通过提供一个大致的可选超时值（秒）进行配置（例如：/WTO:200）。使用值 -1 或 ‘infinite’ 无限期等待。
/discover [search string]	在局域网中搜索 XBOX 主机，可选择按子字符串进行过滤。搜索字符串适用于主机的主机名，而不是其 IP 地址。
/data	返回开发 PC 到主机的连接速度（MBps）。
/?	显示所有可用选项的完整列表。
address[+<accesskey>] [name]	address[+<accesskey>] 指定目标主机的主机名或地址（Tools IP）。 • 设置地址会更改默认主机，除非指定了 /Q 开关。 • 如果未指定地址，则 xbconnect 显示当前存储的默认地址。 • 有关在主机上设置主机名的详情，请参阅为主机 IP 地址设置主机名。使用 accesskey 字符串，只有拥有访问密钥的人员才能访问主机。 • 使用命令 xbconfig accesskey=your-key 设置访问密钥，然后重启你的主机以使访问密钥生效。 • 若要访问已配置访问密钥的主机，请在主机 IP 地址或主机名后面加上加号 (+) 和访问密钥。 • 如果通过 xbconnect 设置默认主机时提供了访问密钥，则该访问密钥会作为默认主机地址的一部分存储。 • 有关访问密钥的更多信息，请参阅 xbconfig accesskey。使用 name 指定要与地址关联的名称。如果未指定名称，则 xbconnect 使用 “devkit” 作为主机标识符。开发工具用来连接到主机的 address 在主机上显示为 Console IP。 • 如果未指定 address 且未设置默认地址，则 xbconnect 显示错误消息。 • 如果未指定 address 但已设置默认地址，则 xbconnect 尝试连接到默认主机地址。这可用于验证默认主机仍可访问。 • 在调用其他远程工具时，你可以使用 /X 开关指定开发工具包以覆盖默认主机地址。
/LC	指定区域设置代码，用于覆盖默认的区域设置代码

在脚本中检查 Title OS 的状态

@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

运行该脚本会产生以下输出。

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  

Connect 诊断测试详情

xbconnect /dx（诊断）会在开发 PC 上本地以及开发主机上运行多种测试，以确定可能导致连接问题的原因。这些测试分为四组，每组中运行不同类别的测试。失败以红色显示，附带错误代码及描述该错误代码的一些详细文本。此外，某些测试还会显示可能对故障排除有用的更多数据。

本地 PC 测试

本地 PC 测试在你的开发 PC 上运行，与开发主机无关。进程运行：测试为了能与 XBOX 开发主机协同工作，应该正在运行的进程。测试的进程包括：

XbtpLinkSvc.exe
XrfsSvc.exe
[!NOTE] 该特定进程可能未启动，这并不一定是真正的失败。

PC 到主机测试

PC 到主机测试从开发 PC 发起，并尝试以各种方式连接到开发主机。

XbtpLink： 测试 PC 与主机之间的 XBTP 协议是否正常工作，可通过传输控制协议 (TCP) 或使用 XBOX Transfer Device (XTD)。
Query IP： 请求主机返回其已知的 IP 地址。
Ping： 尝试使用标准 Internet 控制消息协议 (ICMP) 对提供的 IP 地址的目标主机执行 ping 操作。
Port connections： 尝试连接到开发主机上运行服务的开放端口。这些服务和端口包括：
- XTF (XBOX Tools Framework)：端口 4201/4211/4221
- VS Debugger (Visual Studio Remote Debugger)：端口 4024/4022/4020/4016
- Video Server（XBOX Manager 使用的远程视频服务器）：端口 11442
- WDP (Windows Device Portal for XBOX)：端口 11443

主机测试

主机测试在远程主机上运行，与开发 PC 无关。

Debug NIC： 判断主机上除零售网络端口之外是否还使用了调试网络端口。
进程运行： 测试应在开发主机上运行的进程。这些进程包括 Xtfhost.exe。

主机到 PC 测试

主机到 PC 测试从开发主机发起，并尝试以各种方式连接到开发 PC。

Ping： 尝试使用 PC 提供的 IP 地址对目标开发 PC 执行 ping 操作。
[!NOTE] 会尝试 PC 上的每个可路由地址，但并非所有地址都能从 XBOX 开发主机路由。此测试中特定地址的失败并不罕见。
XbtpLink： 测试开发 PC 与开发主机之间的 XBTP 协议是否正常工作，可通过 TCP 或使用 XTD。

诊断输出示例

诊断输出示例如下截图所示。

另请参阅

命令行工具文件复制 (xbcp.exe) 目录 (xbdir.exe) 诊断信息 (xbdiaginfo.exe)

​在脚本中检查 Title OS 的状态

​Connect 诊断测试详情

​本地 PC 测试

​PC 到主机测试

​主机测试

​主机到 PC 测试

​诊断输出示例

​另请参阅