連線 (xbconnect.exe) - XBOX Game Development Documentation

使用此工具設定或查詢 Microsoft Game Development Kit (GDK) 遠端工具所使用的預設主機位址。

欄 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	只顯示系統名稱或位址，並使用精簡格式。
/T	只顯示工具的名稱或位址，並使用精簡格式。
/N	不嘗試連線至目標位址。
/D	顯示已註冊的擴充功能與處理序組建資訊。
/DX	執行診斷測試，以評估 PC 與 XBOX 開發套件之間的連線健全狀況。如需詳細資訊，請參閱本主題稍後的「連線診斷測試的詳細資料」一節。
/Q	只執行查詢，即使提供了位址也不會註冊預設位址。通常與 /D 一起使用，以直接查詢而不影響預設主機設定。
/QG	查詢 Title OS (Game OS) 是否正在執行。只執行查詢，即使提供了位址也不會註冊預設位址。指令碼通常會使用 /QG 判斷 Title OS 的狀態，以選擇存取遊戲檔案的正確方法。在指令碼中，如果遊戲正在執行，ERRORLEVEL 會設為 0，否則會設為 1。如需在指令碼中檢查 Title OS 狀態的範例，請參閱「在指令碼中檢查 Title OS 的狀態」一節。
/WS[:sec]	• 使 xbconnect 封鎖，直到系統 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]	在 LAN 上搜尋 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  

連線診斷測試的詳細資料

xbconnect /dx (診斷) 會在開發 PC 本機與開發主機上執行各種測試，以判斷可能造成連線問題的原因。這些測試分為四組，每組中會執行數類測試。失敗會以紅色顯示，並附上錯誤碼以及更詳細描述該錯誤碼的文字。此外，部分測試會顯示可能有助於疑難排解的更多資料。

本機 PC 測試

本機 PC 測試會在您的開發 PC 上執行，與開發主機無關。執行中的處理序：測試為了能與 XBOX 開發主機搭配運作而應執行的處理序。測試的處理序包括下列項目：

XbtpLinkSvc.exe
XrfsSvc.exe
[!NOTE] 此特定處理序可能未啟動，但這不一定是真正的失敗。

PC 對主機測試

PC 對主機測試從開發 PC 發起，並嘗試以各種方式連線至開發主機。

**XbtpLink：**測試 PC 與主機之間的 XBTP 通訊協定是否正常運作，無論是透過傳輸控制通訊協定 (TCP) 還是使用 XBOX 傳輸裝置 (XTD)。
**Query IP：**要求主機傳回其已知的 IP 位址。
**Ping：**嘗試使用標準網際網路控制訊息通訊協定 (ICMP) ping 所提供 IP 位址上的目標主機。
**連接埠連線：**嘗試連線至開發主機上執行服務的開放連接埠。這些服務與連接埠包括下列項目：
- XTF (XBOX Tools Framework)：連接埠 4201/4211/4221
- VS Debugger (Visual Studio 遠端偵錯工具)：連接埠 4024/4022/4020/4016
- Video Server (XBOX Manager 使用的遠端視訊伺服器)：連接埠 11442
- WDP (適用於 XBOX 的 Windows Device Portal)：連接埠 11443

主機測試

主機測試會在遠端主機上執行，與開發 PC 無關。

**Debug NIC：**判斷除了零售網路連接埠之外，是否也在使用主機上的偵錯網路連接埠。
**執行中的處理序：**測試應在開發主機上執行的處理序。這些處理序包括 Xtfhost.exe。

主機對 PC 測試

主機對 PC 測試從開發主機發起，並嘗試以各種方式連線至開發 PC。

**Ping：**嘗試使用 PC 提供的 IP 位址 ping 目標開發 PC。
[!NOTE] 系統會嘗試 PC 上的每個可路由位址，但並非所有位址都能從 XBOX 開發主機路由。此測試中特定位址失敗的情況並不少見。
**XbtpLink：**測試開發 PC 與開發主機之間的 XBTP 通訊協定是否正常運作，無論是透過 TCP 還是使用 XTD。

診斷輸出範例

下列螢幕擷取畫面顯示診斷輸出的範例。

另請參閱

命令列工具檔案複製 (xbcp.exe) 目錄 (xbdir.exe) 診斷資訊 (xbdiaginfo.exe)

​在指令碼中檢查 Title OS 的狀態

​連線診斷測試的詳細資料

​本機 PC 測試

​PC 對主機測試

​主機測試

​主機對 PC 測試

​診斷輸出範例

​另請參閱