接続 (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	システム名またはアドレスのみを表示し、ベア形式を使用します。
/T	ツールの名前またはアドレスのみを表示し、ベア形式を使用します。
/N	ターゲットアドレスへの接続を試みません。
/D	登録された拡張機能とプロセスビルド情報を表示します。
/DX	PC と XBOX 開発キット間の接続状態を評価する診断テストを実行します。詳細については、このトピックの後半にある「Connect 診断テストの詳細」セクションを参照してください。
/Q	照会のみを実行し、アドレスが指定されていても既定のアドレスを登録しません。通常は既定のコンソール設定に影響を与えずに直接照会するために /D と共に使用されます。
/QG	タイトル OS (Game OS) が実行中かどうかを照会します。照会のみを実行し、アドレスが指定されていても既定のアドレスを登録しません。 /QG は通常、タイトルのファイルにアクセスする正しい方法を選択するために、タイトル OS の状態を判断するスクリプトで使用されます。スクリプトでは、タイトルが実行中の場合は ERRORLEVEL が 0 に設定されます。そうでない場合は 1 に設定されます。スクリプト内でタイトル OS の状態を確認する例については、「スクリプトでのタイトル 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 をブロックしてタイトル OS が対話できる状態になるまで待機します。既定のタイムアウトは 300 秒で、秒単位のオプションのタイムアウト値を指定して構成できます (例: /WTO:200)。無限に待機するには -1 または ‘infinite’ を使用します。
/discover [search string]	省略可能な部分文字列でフィルターして、LAN 上の XBOX コンソールを検索します。検索文字列は、コンソールのホスト名に対して適用され、IP アドレスに対しては適用されません。
/data	開発 PC からコンソールへの接続速度を MBps で返します。
/?	使用可能なオプションの完全な一覧を表示します。
address[+<accesskey>] [name]	address[+<accesskey>] は、対象コンソールのホスト名またはアドレス ([ツール IP]) を指定します。 • アドレスを設定すると、/Q スイッチが指定されない限り、既定のコンソールが変更されます。 • アドレスが指定されていない場合、xbconnect は現在保存されている既定のアドレスを表示します。 • コンソールのホスト名の設定については、コンソールの IP アドレスにホスト名を設定するを参照してください。 accesskey 文字列を使用して、アクセスキーを持っている人だけにコンソールへのアクセスを提供します。 • コマンド xbconfig accesskey=your-key を使用してアクセスキーを設定し、その後コンソールを再起動してアクセスキーを有効にします。 • アクセスキーで構成されたコンソールにアクセスするには、コンソールの IP アドレスまたはホスト名の後にプラス記号 (+) とアクセスキーを含めます。 • xbconnect で既定のコンソールを設定するときにアクセスキーが指定されている場合、アクセスキーは既定のコンソールのアドレスの一部として保存されます。 • アクセスキーの詳細については、xbconfig accesskey を参照してください。 name を使用して、アドレスに関連付ける名前を指定します。名前が指定されていない場合、xbconnect はコンソール識別子として “devkit” を使用します。開発ツールがコンソールへの接続に使用する address は、コンソールに [コンソール IP] として表示されます。 • address が指定されておらず、既定のアドレスも設定されていない場合、xbconnect はエラーメッセージを表示します。 • address が指定されておらず、既定のアドレスが設定されている場合、xbconnect は既定のコンソールのアドレスへの接続を試みます。既定のコンソールがまだアクセス可能かを確認するために使用できます。 • 他のリモートツールを呼び出すときに、/X スイッチを使用して開発キットを指定することで、既定のコンソールのアドレスをオーバーライドできます。
/LC	ロケールコードを指定します。既定のロケールコードをオーバーライドするために使用します。

スクリプトでのタイトル 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 と開発コンソールの両方でさまざまなテストを実行します。これらのテストは 4 つのグループに分かれており、各グループでカテゴリ別のテストが実行されます。失敗は赤色で表示され、エラーコードとエラーコードをより詳しく説明するテキストが表示されます。さらに、一部のテストではトラブルシューティングに役立つデータも表示されます。

ローカル PC テスト

ローカル PC テストは開発 PC 上で実行され、開発コンソールに依存しません。プロセスの実行: XBOX 開発コンソールで作業するために実行する必要のあるプロセスをテストします。テストされるプロセスには次のものが含まれます。

XbtpLinkSvc.exe
XrfsSvc.exe
[!NOTE] この特定のプロセスは開始されていない場合があり、必ずしも真の失敗ではありません。

PC からコンソールへのテスト

PC からコンソールへのテストは、開発 PC で開始され、さまざまな方法で開発コンソールへの接続を試みます。

XbtpLink: PC とコンソール間で XBTP プロトコルが Transmission Control Protocol (TCP) 経由または XBOX Transfer Device (XTD) を使用して動作していることをテストします。
Query IP: コンソールに、知られている IP アドレスを返すように要求します。
Ping: 標準のインターネット制御メッセージプロトコル (ICMP) を使用して、提供された IP アドレスでターゲットコンソールに対する ping を試みます。
ポート接続: 開発コンソール上でサービスが実行されている開いたポートへの接続を試みます。これらのサービスとポートには次のものが含まれます。
- XTF (XBOX Tools Framework): ポート 4201/4211/4221
- VS Debugger (Visual Studio リモートデバッガー): ポート 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 を使用して動作していることをテストします。

診断出力の例

診断出力の例を次のスクリーンショットに示します。

​スクリプトでのタイトル OS の状態確認

​Connect 診断テストの詳細

​ローカル PC テスト

​PC からコンソールへのテスト

​コンソール テスト

​コンソールから PC へのテスト

​診断出力の例

​関連項目