Connect (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	System 이름 또는 주소만 표시하고 최소 형식을 사용합니다.
/T	도구의 이름 또는 주소만 표시하고 최소 형식을 사용합니다.
/N	대상 주소에 연결을 시도하지 않습니다.
/D	등록된 확장 및 프로세스 빌드 정보를 표시합니다.
/DX	PC와 XBOX Development Kit 간의 연결 상태를 평가하기 위해 진단 테스트를 실행합니다. 자세한 내용은 이 문서의 뒤에 있는 Connect 진단 테스트에 대한 세부 정보 섹션을 참고하세요.
/Q	쿼리만 수행하고, 주소가 제공된 경우에도 기본 주소를 등록하지 않습니다. 일반적으로 기본 콘솔 설정에 영향을 주지 않고 직접 쿼리하기 위해 /D와 함께 사용됩니다.
/QG	Title OS(Game OS)가 실행 중인지 쿼리합니다. 쿼리만 수행하고, 주소가 제공된 경우에도 기본 주소를 등록하지 않습니다. /QG는 일반적으로 스크립트가 Title OS의 상태를 결정해 타이틀 파일에 액세스하는 올바른 방법을 선택하는 데 사용됩니다. 스크립트에서는 타이틀이 실행 중인 경우 ERRORLEVEL이 0으로 설정되고, 그렇지 않으면 1로 설정됩니다. 스크립트에서 Title OS 상태를 확인하는 예는 스크립트에서 Title OS 상태 확인 섹션을 참고하세요.
/WS[:sec]	• System OS가 상호 작용할 준비가 되거나 시간 초과에 도달할 때까지 xbconnect가 차단되도록 합니다. • 기본 시간 초과는 120초입니다. xbconnect /WS:200과 같이 사용자 지정 값을 지정하는 옵션이 있습니다. • 콘솔이 준비되면 ERRORLEVEL=0을, 시간 초과에 도달하면 ERRORLEVEL=1을 반환합니다. • 콘솔이 명령을 받을 준비가 된 시점을 결정하는 신뢰할 수 있는 방법을 제공합니다. 예를 들어 xbreboot 이후 xbapp launch를 호출할 수 있는 때를 결정합니다. • 무제한 대기하려면 -1 또는 “infinite”를 사용합니다.
/WTP[:sec]	• Title 프로세스가 상호 작용할 준비가 될 때까지 xbconnect가 차단되도록 합니다. 기본 시간 초과는 300초이며, 초 단위의 대략적인 선택적 시간 초과 값을 제공하여 구성할 수 있습니다(예: /WTP:200). 무제한 대기하려면 -1 또는 ‘infinite’ 값을 사용합니다.
/WT[:sec]	• Game OS가 상호 작용할 준비가 되거나 시간 초과에 도달할 때까지 xbconnect가 차단되도록 합니다. • 기본 시간 초과는 120초입니다. xbconnect /WT:200과 같이 사용자 지정 값을 지정하는 옵션이 있습니다. • 콘솔이 준비되면 ERRORLEVEL=0을, 시간 초과에 도달하면 ERRORLEVEL=1을 반환합니다. • Game OS가 초기화를 완료하고 게임이 시작된 시점을 결정하는 신뢰할 수 있는 방법을 제공합니다. • 무제한 대기하려면 -1 또는 “infinite”를 사용합니다.
/WTO[:sec]	• Title OS가 상호 작용할 준비가 될 때까지 xbconnect가 차단되도록 합니다. 기본 시간 초과는 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  

Connect 진단 테스트에 대한 세부 정보

xbconnect /dx(진단)는 개발 PC와 개발 콘솔 모두에서 로컬로 다양한 테스트를 실행하여 연결 문제의 원인이 무엇일 수 있는지 확인합니다. 이러한 테스트는 네 개의 그룹으로 나뉘며, 각 그룹에서 여러 카테고리의 테스트가 실행됩니다. 오류는 오류 코드와 해당 오류 코드를 더 자세히 설명하는 일부 텍스트와 함께 빨간색으로 표시됩니다. 또한 일부 테스트는 문제 해결에 유용할 수 있는 추가 데이터를 표시합니다.

로컬 PC 테스트

로컬 PC 테스트는 개발 PC에서 실행되며 개발 콘솔과 독립적입니다. 프로세스 실행: XBOX 개발 콘솔과 작업하려면 실행되어야 하는 프로세스를 테스트합니다. 테스트되는 프로세스는 다음과 같습니다.

XbtpLinkSvc.exe
XrfsSvc.exe
[!NOTE] 이 특정 프로세스는 시작되지 않을 수 있으며, 이는 반드시 실제 실패는 아닙니다.

PC에서 콘솔로의 테스트

PC에서 콘솔로의 테스트는 개발 PC에서 시작하여 다양한 방법으로 개발 콘솔에 연결을 시도합니다.

XbtpLink: TCP(전송 제어 프로토콜) 또는 XTD(XBOX Transfer Device)를 통해 PC와 콘솔 간에 XBTP 프로토콜이 작동하는지 테스트합니다.
Query IP: 콘솔에 알려진 IP 주소를 반환하도록 요청합니다.
Ping: 표준 ICMP(인터넷 제어 메시지 프로토콜)를 사용해 제공된 IP 주소에서 대상 콘솔을 핑하려고 시도합니다.
포트 연결: 개발 콘솔에서 서비스를 실행하는 열린 포트에 연결을 시도합니다. 이러한 서비스와 포트는 다음과 같습니다.
- XTF(XBOX Tools Framework): 포트 4201/4211/4221
- VS 디버거(Visual Studio Remote Debugger): 포트 4024/4022/4020/4016
- 비디오 서버(XBOX Manager에서 사용되는 원격 비디오 서버): 포트 11442
- WDP(Windows Device Portal for XBOX): 포트 11443

콘솔 테스트

콘솔 테스트는 원격 콘솔에서 실행되며 개발 PC와 독립적입니다.

Debug NIC: 콘솔의 디버그 네트워크 포트가 리테일 네트워크 포트와 함께 사용되고 있는지 확인합니다.
프로세스 실행: 개발 콘솔에서 실행되어야 하는 프로세스를 테스트합니다. 이러한 프로세스에는 Xtfhost.exe가 포함됩니다.

콘솔에서 PC로의 테스트

콘솔에서 PC로의 테스트는 개발 콘솔에서 시작하여 다양한 방법으로 개발 PC에 연결을 시도합니다.

Ping: PC에서 제공하는 IP 주소를 사용해 대상 개발 PC를 핑하려고 시도합니다.
[!NOTE] PC의 모든 라우팅 가능한 주소가 시도되지만, 모든 주소가 XBOX 개발 콘솔에서 라우팅 가능한 것은 아닙니다. 이 테스트에서 특정 주소의 실패는 드문 일이 아닙니다.
XbtpLink: TCP 또는 XTD를 통해 개발 PC와 개발 콘솔 간에 XBTP 프로토콜이 작동하는지 테스트합니다.

진단 출력 예

진단 출력의 예는 다음 스크린샷과 같습니다.

참고

명령줄 도구 파일 복사 (xbcp.exe) 디렉터리 (xbdir.exe) 진단 정보 (xbdiaginfo.exe)

​스크립트에서 Title OS 상태 확인

​Connect 진단 테스트에 대한 세부 정보

​로컬 PC 테스트

​PC에서 콘솔로의 테스트

​콘솔 테스트

​콘솔에서 PC로의 테스트

​진단 출력 예

​참고